515 



Scientific Data Systems 

A XGROX COMPANY 



5|D£ 5IGMR MANAGE 



Reference Manual 



Price: $2.25 



MANAGE 
REFERENCE MANUAL 

for 
SDS SIGMA 5/7 COMPUTERS 



PRELIMINARY EDITION 
90 16 10A 
July 1969 



SCIENTIFIC DATA SYSTEMS a xerox company /701 South Aviation Boulevard/El Segundo, California 90245 



)1969, Scientific Data Systems, Inc. Printed in U.S.A. 



RELATED PUBLICATIONS 



Title Publication Number 



Sigma 5 Computer Reference Manual 90 09 59 

Sigma 7 Computer Reference Manual 90 09 50 

Sigma 5/7 Batch Processing Monitor Reference Manual 90 09 54 

Sigma 5/7 Batch Processing Monitor Operations Manual 90 1 1 98 

Sigma 5/7 Sort/Merge Reference Manual 90 11 99 



The specifications of the software system described in this publication are subject to change without notice. The availability or performance of some features may 
depend on a specific configuration of equipment such as additional tape units or larger memory. Customers should consult their SDS sales representative for details. 



CONTENTS 



1. INTRODUCTION 

Manage Program Characteristics 

Manage File Characteristics 

Manage System Components 

General Procedures 



Equipment Configuration Requirements 

DICTNARY 
File Constraints 



Calling Dictnary 

File Definition Card 

Field Definition Card 

Sample File Description 
Dictnary Messages 



3. FILEUP 



Master File Design 

Transaction File Design 

Audit File Design 

User Own-Code 

Field Conversion 

Calling Fileup 



File Update Card 

Field Update Card 

Creation of a Sample Master File 
Fileup Messages 



RETRIEVE 

Selection Criteria 

Arithmetic Expressions 
Data Formats 



Calling Retrieve 

General Request Specification Card 
Title and Heading Card 



Retrieval Specification Card 
Retrieved Output Card 



Sample Data Retrieval and Report 
Retrieve Messages 



5. REPORT 



Report Specifications _ 
Report Conventions 

Horizontal Totaling 

Text Fields 



Alphabetic Fields 



Binary Fields and Expressions 

Fractional Significance 

Calling Report 



Report Messages 



11 
11 
12 
12 
12 
13 
14 
15 
16 
16 



22 
23 
24 

.24 
25 
27 
27 
29 

"31 
31 



INDEX 



39 
39 
39 
39 
39 
40 

'40 
40 

.40 

56 



APPENDIXES 

A. SAMPLE MANAGE DECK SETUPS 

B. DCB NAMES FOR MANAGE PROCESSORS 

C. OWN-CODE LINKAGE FOR FILEUP 

D. SAMPLE MANAGE RUNS 
USAGE INCREASE PROBLEM 



ILLUSTRATIONS 

Sample Variable-Length Record 
Manage Dictnary Specifications 



1. 

2. 

3. 

4. 

5. 

6. 

7. 

8. 

9. 

10. 

11. 

12. 

13. 

14. 

D-l. 

D-2. 

D-3. 

D-4. 
D-5. 
D-6. 



1. 
2. 
3. 

A 



Sample Personnel Master File Specifications 

Manage Fileup Specifications 

Sample Transaction Records 



Sample Fileup Specifications 

Sample Comparison With OR Connector 



Wage Problem Retrieval Specifications 

Wage Problem Report Specifications 

Wage Problem Report 



TABLES 



Manage Programs 



Transaction Data Field Sizes 



DCB Names for Manage Processors 
Register Use for Own-Code Linkage 



42 

46 

48 

49 
54 



15 

17 

18 

24 

Sample Comparison With AND Connector 24 

Manage General Request Specifications 26 

Manage Retrieval Specifications 28 

Manage Retrieved Output Specifications 29 

Sample General Request Specifications 32 

Sample Retrieval Specifications 32 

Sample Report Specifications 33 

Sample Dictionary 50 

Sample Retrieved Data Report 51 

Wage Problem General Request 

Specifications 



.53 

.54 

.54 

55 



2 

13 
.47 
49 



1. INTRODUCTION 



SDS Manage is a generalized file management system that 
permits decision makers with limited programming knowl- 
edge to make use of computerized data files. 

Manage eliminates the need to write individual computer 
programs for performing many of the tasks associated with 
using a flexible and responsive management information sys- 
tem. It is made up of several subprograms which perform 
the functions of building the data base or making use of it. 
To use any of the subprograms, the user enters control codes 
and data from the appropriate Manage forms into the system, 
and the specified job will be performed. 

In a typical installation, setting up the initial data files and 
generating standard reports will be handled by experienced 
business analysts or programmers. Some companies will pre- 
fer that all Manage processing be handled by computer de- 
partment personnel only. However, Manage is designed so 
that a businessman or manager can use the system directly, 
with a minimum of data processing orientation. Reports to 
be printed (maximum of 99) are generated from only one 
pass through the data file, regardless of the complexity of 
the specified reports. 

This chapter provides the user with general information on 
Manage program and file characteristics, and on system 
component programs. These component programs are ex- 
plained in detail in Chapters 2, 3, 4, and 5. Appendix A 
presents some sample Manage deck setups, and Appendix B 
gives DCB names used by the Manage processors. Appendix 
C describes the use of registers for own-code linkage during 
the FILEUP phase of operation. Appendix D shows several 
sample Manage runs. 

In the following chapters, certain conventions have been 
adopted for defining Manage commands. Capital letters 
indicate command words that are required in the literal 
form shown. Lower case letters are figurative representa- 
tions of parameters. Command parameters enclosed by 
braces (i S) indicate a required choice. Parameters en- 
closed by brackets ( [ ] ) are optional. 



MANAGE PROGRAM CHARACTERISTICS 



The programs that constitute Manage may be classed as 
"load and go" file-processing compilers. Each is a gener- 
alized program oriented toward a data file dictionary. Each 
data file dictionary describes the format of one specific data 
file. Using control parameters and applicable data file 
dictionaries, these programs perform the following functions: 

• Create and maintain files in almost any format. 

• Retrieve information, selectively or nonselecfively, 
from such files. 

• Report and/or summarize retrieved information accord- 
ing to the user's requirements. 



File creation and maintenance entails setting up a new file 
or modifying the contents of an existing file. File mainte- 
nance functions consist of inserting, deleting, and chang- 
ing records in a file. 

Data retrieval includes the selection of records (or parts of 
records) from a single master file or two matching files. 
The selection criteria are specified by the user and allow 
him to examine the relationships between data fields, con- 
stants, and the results of arithmetic operations on data 
fields. Up to 99 criteria can be specified in any one re- 
quest, linked by either of the logical operators AND and 
OR. Selection tests include "greater than", "less than", 
and "equal to" conditions, as well as their negatives. 
Data-retrieval queries involving a file can be processed in 
a single run, or as groups of up to 99 such queries involv- 
ing the same file. It is also possible to select every rec- 
ord (or parts of every record) by the absence of selection 
criteria and the inclusion of an additional parameter. 

Report generation involves editing of selected data fields 
into a prescribed format and sequence, automatic insertion 
and alignment of columnar headings, counting of items 
within groups, performing necessary punctuation of numeric 
data, and summarizing data in the report. 



MANAGE FILE CHARACTERISTICS 



The data file dictionary is the central control element in 
the Manage system. It consists of definitions (recorded in 
a RAD-based library) that precisely describe the character- 
istics of a particular data file. Because each data file dic- 
tionary relates to only one data file, a system contains as 
many dictionaries as there are files. All current data file 
dictionaries are contained in file DICT. 

Control and formatting parameters need be defined only 
once; they are centralized in dictionary form in the RAD 
library. Note that this is an improvement on conventional 
program generators, which typically require file definition 
parameters to be submitted as input each time a report is 
prepared from a file. 

Manage processes records that are organized by fields. 
Each field contains data in any one of the following 
representations. 

1. Alphabetic: the standard SDS EBCDIC character set. 
The various Manage programs will insert, change, or 
compare fields containing up to 255 bytes of this type 
of data. Up to 999 bytes of data of this type may be 
defined as a text field for insertion and change pur- 
poses. However, the various Manage processors can 
use a maximum of 255 of these bytes for comparison 
and sorting purposes. No arithmetic will be per- 
formed on alphabetic fields by these processors. 
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2. Binary: a fixed-point, signed, binary integer value, 
from 1 to 4 bytes in length. Arithmetic and algebraic 
comparisons may be performed on data of this type. 

3. Packed Decimal : a signed, decimal digit value, from 
1 to 31 digits long, packed into a 1- to 16-byte field. 
Arithmetic and algebraic comparisons may be performed 
on data of this type. 

Files to be handled by a Manage processor must be sequen- 
tial files. These sequential files may consist of either 
fixed- or variable-length records. If fixed-length rec- 
ords are specified, Manage will process blocked records 
from user-formatted or foreign files. Variable-length rec- 
ords may be blocked only in Monitor-formatted files. 

A variable-length record consists of a fixed-length root 
segment and a variable number of multiple-entry fields. 
Any number of different multiple-entry fields may be spe- 
cified. Every multiple-entry field must specify a counter 
field in the root segment of each record. This counter field 
contains the actual number of multiple entries existing in 
that record, and is controlled automatically by Manage. 
If more than one multiple-entry field cites the same counter 
field, the multiples are said to be grouped. One of the 
fields in a group is designated as a group key. Deleting 
a group key deletes the entire group. 

The number of multiple-entry fields actually appended to 
a variable-length record is controlled by the values found 
in the counter fields. The order of appearance of all 
multiple-entry fields is specified by the user. 

Fdr example, consider a personnel master file in which each 
employee is represented by one logical record. The fixed 
portion of each record might contain identification and cur- 
rent status, while the multiple entries show level of educa- 
tion and job history. None or all of these types of fields 
could be present, but always in the same order of appear- 
ance, with Degree first, Major second, Job third, etc. 



The value in the counter specifies how many fields actually 
exist. Figure 1 shows such a variable-length record. 



MANAGE SYSTEM COMPONENTS 



Programs that constitute the Manage system interface with 
the data file dictionary that describes the format of the 
specific data file to be processed. Using parameters from 
control cards and applicable data file dictionaries, the pro- 
grams perform file creation and maintenance, selective and 
nonselective data retrieval, and report generation. The 
programs in the Manage system are shown in Table 1. 



Table 1. Manage Programs 



Program 
Name 


Purpose 


Dictnary 


Creates and maintains Manage file 
dictionaries and generates dictionary 
listing. 


Fileup 


Creates and maintains data files. 


Retrieve 


Performs selective and nonselective 
data retrieval and formatting. 


Report 


Generates reports automatically (in- 
put is from Retrieve). 


Sort 


Called as a subroutine to perform 
preliminary sorting for Dictnary, 
Fileup, and Retrieve data, and 
for Report listings when required. 



Counter Counter 
1 2 



Group 1 



Group 2 



~\r 



Name 


Hire 
Date 


Current 
Position 


Rate 


No. 

Degs 

and 

Majors 

05 


No. 
Jobs 
02 


Degree 


Major 


Job 


AA 


MA 


MBA 


PHD 


LLD 


Art 


Lit 


Acct 


Hist 


Law 


Prog- 
rammer 


Manager 



■Fixed-Length Root Segment 



-*-*- 



Multiple-Entry Fields 



Note that group 1, composed of fields Degree and Major, is controlled by counter field 1, "No. Degs and Majors" but 
that group 2, composed of Job only, is controlled by counter field 2 "No. Jobs". Degree could be designated a group 
key; then, deleting the third Degree (MBA) would also delete the third Major (Acct). 



Figure 1. Sample Variable-Length Record 



2 Manage System Components 



GENERAL PROCEDURES 



The processes of file definition (via Dictnary), and file 
creation and maintenance (via Fileup) continue to be the 
responsibility of experienced computer analysts and pro- 
grammers. However, the need for technical talent to make 
use of a Manage-oriented information system decreases 
markedly after the initial data base creation. Once the 
appropriate information has been captured in computer 
files, managers can make extensive use of it without any 
intervening computer programming effort. This reduces 
the delay between conception of a report and its actual 
delivery. 

The system is extremely flexible, and is very useful for un- 
anticipated exception reports. Additionally, the user may 
request output of a catalog containing either the dictionary 
of a particular data file, or the complete contents of file 
DICT (all current data file dictionaries). A catalog of an 
individual data file dictionary contains user-supplied in- 
formation for the file and its fields, ordered by starting- 
byte position, and a list of field names and their starting- 
byte positions, ordered alphabetically. 

The quick response time of a Manage information system 
is achieved through use of its general purpose retrieval 
program. This program selects requested information from 
a data file on any Sigma storage medium. The selection 
and the final disposition of the information is initiated by 
filling in the following set of request forms: 

1. General Request Specifications Form 

2. Retrieval Specifications Form 

3. Retrieved Output Specifications Form 

These simple forms are capable of describing highly com- 
plex combinations of retrieval and reporting. Each re- 
trieval described by the forms is called a request and is 
given a request number. Up to 99 multiple requests can 
be satisfied at the same time, that is, by a single pass 
through the data file. The Retrieve control cards that are 
punched from the forms, whether for a single request or for 
multiple requests, need not be entered in any definite order. 

The request specification forms are filled out, giving the 
characteristics of the retrieval and reporting operations. 
They are punched on cards and provided to Retrieve, which 
reads them and verifies them for correct syntax. The speci- 
fications for all the required reports are then placed in a 
report specification output file. The specified data base 
file is then opened and each record in it is examined. If 



needed, a matching "secondary" file record can also be 
included in the selection process. Under this procedure, 
only those primary records with a matching secondary will 
be examined for retrieval. In the event of multiple secon- 
dary records with a matching primary, only the first secon- 
dary will be examined for retrieval. All fields in both 
matching records are accessible for any standard usage. 
The retrieval criteria for each individual request are used 
to select records or portions of records from the inputs and 
to pass the "hits" into a retrieved output file. 

The report-specification and refrieved-outpuf files are 
passed to Report for the final processing steps. The speci- 
fications for listing each report are examined in the fol- 
lowing cycle: 

1. If the report is in a sequence different from that of the 
original data base, Sort is called to create a re- 
sequenced file. 

2. The report is formatted as specified in the originating 
request. 

3. The report is printed. 

EQUIPMENT CONFIGURATION REQUIREMENTS 

The minimum system requirement is a Sigma 5/7 with Batch 
Processing Monitor capability. It is estimated that most 
meaningful applications can be processed with 15,000words 
of storage available for the Manage processors and working 
areas. Also, approximately 28,000 words of RAD storage 
will be dedicated to Manage program storage. Each user 
file dictionary entered into the system will require approx- 
imately five words of RAD space per defined field. 

All Manage processors use byte string operations, thus re- 
quiring the byte string simulator on the Sigma 5. 

If any packed-decimal fields are defined by the user, or 
if print-editing functions are requested, the decimal hard- 
ware or decimal simulator is required. 

The retrieval process is programmed to generate a large 
temporary file (the retrieved records) on the RAD. The 
space required is therefore user-dependent and cannot be 
estimated. If magnetic tape units are available, the user 
may reduce his RAD requirements by assigning the retrieved 
records to tape. 

The report process may call upon Sort before listing each 
request. This will require temporary RAD space to hold all 
data records retrieved for a given request. If magnetic tape 
units are available, the user may reduce his RAD require- 
ments by assigning the Sort program's files to tape. 



General Procedures/Equipment Configuration Requirements 



2. DICTNARY 



Dictnary is the Manage dictionary-generating program 
that creates and updates the data file dictionaries, which 
describe the user's file characteristics. These user data 
file dictionaries are in turn processed by other Manage 
programs. (Any non-Manage program may read the dictio- 
nary, but alteration by other than the dictionary genera- 
tor is not allowed.) The data dictionaries are kept in the 
system RAD library as the file named DICT. Two records 
are required for each user's file description. In addition 
to generating dictionaries, Dictnary outputs a catalog of 
file dictionaries and other information, subject to user 
specification. 

Logically, the dictionary generator must be the first Man- 
age function to be performed, but it is independent of other 
Manage programs and need not be run with the others. It 
is important that the correct time and date be input at sys- 
tem load-time to ensure proper dating when the dictionary 
generator and the other Manage programs are called. 

Each data file dictionary contains the following information: 

1. General user file structure. 

2. Format of the records that constitute the user file. 

3. Attributes of the data fields contained in a record. 

4. Processor-dependent parameters such as punctuation 
and column headings for the Report program. 



FILE CONSTRAINTS 

Each file must have at least one sort key. This parameter 
is required by Fileup to ensure proper sequence of the data 
base. 

All fields (other than sort key fields) may be redefined 
completely or in part. For example, an alphabetic area 
defined as "ADDRESS" might have two other fields called 
"STREET" and "CITY" which reference parts of the overall 
area. Redefinition is also permitted for fields containing 
packed decimal or binary values, but is not permitted for 
multiple-entry fields. 

In addition, each data file with variable-length records is 
subject to the restrictions listed below: 

1. Files containing blocked records must be Monitor- 
formatted (LABEL or FILE parameter in a DCB ASSIGN). 
Unblocked records may be either Monitor- formatted or 
user-formatted (DEVICE parameter in a DCB ASSIGN). 

2. Multiple-entry fields, ordered consecutively must 
follow the fixed fields in a record. 

3. A multiple-entry field must reference a separate 
counter field (present in every record) that contains 
the number of iterations of the multiple-entry field 
in that record. 



4. A counter field may be referenced by more than one 
multiple-entry field, but each multiple-entry field 
may reference only one counter. Counter fields must 
always be defined as binary values. 

5. Counter fields and key fields may not be defined as 
multiple fields. 

6. Groups of multiple fields that reference the same 
counter must always have a group key field. In a 
group consisting of only one data field, it also is 
designated as a group key. 

The maximum number of fields in any one data file's dic- 
tionary is 409. The maximum number of multiple-field 
groups per file is 15. 

Record and field sizes are generally limited by the number 
of digits that can be handled in the size columns of the 
specification cards. However, the following outline pre- 
sents practical limitations: 

1. Binary fields are limited to 4 bytes. 

2. Packed-decimal fields are limited to 31 digits, plus 
an algebraic sign. 

3. Mixed-mode arithmetic operations or comparisons 
will not be performed by Retrieve or Report. 

4. Alphabetic fields are limited to 255 characters for 
comparison and sorting purposes. 

5. Text fields are limited to 999-character fixed fields. 
No arithmetic or editing can be done. (If a text 
field is a key field, comparison is limited to the first 
255 characters.) The purpose of text fields is to print 
horizontal text in Report regardless of other column 
usage. 

6. Depending on field size, other Manage programs may 
truncate (from the left) or round values when doing 
arithmetic operations. 

7. If user labels consist of multiple records and/or an 
end-of-file gap, the file must be specified as user- 
formatted. 



CALLING DICTNARY 

Input for a Dictnary run consists of the following cards: 

1. Dictnary processor call card. 

2. File definition cards. 

3. Field definition cards. 

Sort orders the definition cards by file name, card type, 
fixed fields, multiple fields, and starting position or 
multiple-order number. File dictionaries are processed 
one by one and field by field. Errors will be flagged by 



Dictnary 



diagnostic messages accompanied by the incorrect card 
image. If errors are found, the new version will be re- 
jected without affecting the existing dictionary. (If the 
catalog is restricted to successful updates and creations, 
the file's dictionary will not be cataloged. If the catalog 
is to be of all dictionaries, the old version, if any, will 
apply.) 

The catalog will be output after all updates and creations 
have been processed. The first page of the catalog con- 
tains the names of files successfully updated or created. 
The exceptions are dictionaries that have been deleted 
and those with a suppress indicator on the file definition 
card. Deleted file dictionaries are noted in messages 
output before the catalog. 

Formats of Dictnary cards are given below. An asterisk (*) 
after column numbers indicates that the field is optional. 

The format of the Dictnary processor call card is fixed. 
As it signals BPM to link the dictionary generator, it must 
be the first card in the deck. Its form is shown below, 



Columns Description 



IDICTNARY6 



A 

IS . 



'DICTNARY 
umn 1. 



is required as shown, starting in col- 



£ indicates a blank character in column 10. 



A 
S. 



indicates the type of catalog to be printed. 
A blank character in column 11 specifies that 
the catalog is to consist of those file diction- 
aries successfully created or updated during 
this run. An A indicates that the catalog is to 
consist of all file dictionaries in existence. An 
S (suppress) means that no catalog is to be 
printed. 



Both file and field definition cards may be input for more 
than one file at a time without being ordered. 



FILE DEFINITION CARD 

See Figure 2 for a diagram of the file definition card. The 
file definition record is not required when an existing dic- 
tionary is being changed. 

Columns Description 



1 
2-9 



1 : identifier for file definition records. 

File name: a left-justified name composed of 
eight alphabetic (EBCDIC) characters. Em- 
bedded blanks are not allowed, though trail- 
ing blanks are acceptable. The allowed char- 
acters are A to Z, to 9, @, $, # , and %. 



10-13 Maximum logical record length: from 0001 

through 9999 bytes, with leading zeros; field 
is blank if only a dictionary list is required 
(see column 18). 

14-16* Blocking factor: for user-formatted file, from 

001 through 999; for Monitor- formatted file, 
zeros or blanks. (See column 18). 

17* User header label indicator: an H indicates 

that the header is a single record, F indicates 
that the header consists of one or more records 
ending with a file mark. (See column 18). 

18* Dictionary list option: an L means that this 

file's dictionary should be purged of any void 
entries and then listed. The L option is used 
when other specifications on this card are blank 
and no field definition cards for this file are 
input. An S indicates that the listing of this 
dictionary creation or update should be sup- 
pressed (unless the Dictnary processor card 
specifies that all dictionaries be listed). 

19-80* Comments: left-justified alphanumeric field 

to be listed in the dictionary catalog. 

An existing dictionary may be deleted completely by sub- 
mitting a file definition card with no record characteris- 
tics or dictionary list option (that is, columns 10 to 18 
blank). The complete deletion of a file dictionary will be 
noted in the listing output before the catalog with the file 
name and a suitable message. Also, the latest contents of 
any dictionary may be listed by submitting a file defini- 
tion card with an L in the dictionary list option (column 18). 
A scan will take place to purge void entries. (A void entry 
is created when an existing definition is changed from a 
fixed field to a multiple-entry field. This void entry exists 
until the next update or list of that dictionary, at which 
time it is deleted. ) 



FIELD DEFINITION CARD 

See Figure 2 for a diagram of the field definition card. 

Columns Description 

1 2: identifier for field definition records. 

2-9 File name: a left-justified name composed 

of eight alphabetic (EBCDIC) characters. Em- 
bedded blanks are not allowed, though trail- 
ing blanks are acceptable. The allowed char- 
acters are: A to Z, to 9, @, $, # , and %. 

10-17 Field name: a left-justified name composed 

of eight alphabetic (EBCDIC) characters. 
Embedded blanks are not allowed, though 
trailing blanks are acceptable. The allowed 
characters are: A to Z, to 9, @, $, 
# , and %. 



File/Field Definition Card 
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Figure 2. Manage Dictnary Specifications 



Columns Description 



Columns Description 



18-21 Starting-byte position or multiple-entry order: 

four-digit starting-byte location of this fixed 
field. The leftmost byte in a record is byte 
0001, the second is 0002, etc. If the field is 
a multiple-entry field, this value indicates its 
ordering as to all other multiple-entry fields, 
that is, 0001 for the first multiple-entry field, 
0002 for the second, etc. Blanks are used if 
this field is to be deleted. 



22-24 Field length: from 001 through 999 bytes, 

with leading zeros. Blanks are used if this 
field is to be deleted. 

25* Key level: if the field is blank, it is not a 

key field. An M indicates that this is a 
muitipie-entry group key. It associates aii 
multiple entries tied to the same counter. A 
numeral from 1 through 9 indicates that this 
is a file sort key. The specified value is the 



26 



27 



sort level, where 1 specifies the primary-level 
sort, 2 is the secondary-level sort, etc. A 
text field comparison is limited to the first 
255 characters. Note that at least one fixed 
field must be a sort key, and one multiple 
field in each counter field's group must be 
the group key. 

Sort direction: used for file sort key fields 
only, where a blank indicates an ascending 
sort, and D indicates a descending sort. 

Field type: indicated by one of the following 
codes. 



Code Type 



Maximum Length 



B Binary 4 bytes 

P Packed decimal 16 bytes 



Field Definition Card 



Columns 



28* 



29" 



30" 



31' 



32" 



33* 

34-41* 



Descri 


iption 


Code 


Type 


A 


Alphabetic 
(EBCDIC) 


T 


Text 
(EBCDIC) 



Columns Description 



Maximum Length 
255 bytes 



999 bytes 



Note that packed decimal fields always con- 
tain an odd number of digits equal to (byte 
length x 2) -1. If the field type is text, com- 
parison is limited to the first 255 characters. 

Decimal scaling (for packed decimal fields): 
specifies the number of positions to the right 
of the decimal point. The field may contain 
a blank (no decimal point will be printed), or 
a numeral from 1 through 9. For example, a 
field whose length is specified as seven digits 
and has a decimal point code of 3 takes the 
form nnnn. nnn upon being printed. Note that 
the decimal point is not actually carried in 
the data, but is inserted only at the time of 
printing. 

Zero suppress: a Z entry inhibits the printing 
of leading zeros for the field's contents. If 
column 29 is left blank, leading zeros are 
printed unless the field also has a C (comma) 
specification in column 30. 

Comma insertion: a C causes commas to be 
inserted in a numeric field prior to printing. 
Commas are placed to the left of every third 
digit counting from the units position. Thus, 
a numeric field whose contents are 1000000 
will be printed as 1,000,000. If the contents 
were 0600000, the displayed quantity would 
appear as 600,000. Note that comma inser- 
tion forces suppression of leading zeros, 
whether specified or not (see zero suppress 
code, above). If column 30 is blank, commas 
are not inserted, nor are leading zeros sup- 
pressed (unless zero suppression is explicitly 
called for by use of the zero suppress code). 

Dollar sign: a $ character causes a dollar 
sign to precede the most significant digit of 
a numeric field on printout. If column 31 is 
left blank, a dollar sign is not inserted. 

Minus sign: a "-" causes a trailing minus 
sign to be printed when the field's content 
is negative. If column 32 is blank, the sign 
of the value will not be printed regardless of 
the field's content. 

Multiple-entry indicator: an M indicates 
that this is a multiple-entry field. 

Multiple field's counter name: name of the 
previously-defined root-segment field that is 
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the counter for the number of occurrences of 
this field in any given record. The left-justified 
name is composed of eight alphabetic (EBCDIC) 
characters. Embedded blanks are not allowed, 
though trailing blanks are acceptable. The al- 
lowed characters are A to Z, to 9, @, $, *, 
and %. 

Audit: an A indicates that a change of data in 
this field due to a file update will cause the en- 
tire record to be dumped in an audit file. 



43-80* Standard column heading: up to 38 EBCDIC char- 

acters of heading to be used when this field is 
printed. The > character (greater than) will in- 
dicate a new heading line for REPORT. 

An already existing field definition may be deleted by sub- 
mitting a field definition card with no characteristics other 
than file and field name (that is, columns 18 to 80 blank). 
A field's deletion will not be noted. 



SAMPLE FILE DESCRIPTION 



Definition of a sample personnel master file and the asso- 
ciated field names are listed below. The file contains fixed- 
length records (that is, no multiple-entry groups) and is 
maintained in employee-number sequence within each com- 
pany division. 



Field Description Field Name 

Corporation Division 

Number DIVISION 

Employee Number EMPNO 



Employee Name 


NAME 


Street Address 


LI 


Employee Address 


ADDRESS 


City and State 


L2 


Zip Code 


ZIP 


Social Security 




Number 


SOSECNO 


Date of Birth 


BIRTHDTE 


Sex 


SEX 


Marital Status 


MARITAL 



Comments 



A five-digit 
number 



First line only 
The entire address 
Second line only 



Month, Day, Year 

Mor F 

Code Meaning 



M 



ried 



S single 

D divorced 



W 



widowed 



Sample Field Description 



Field Description Field Name Comments 

Citizenship Status CITIZEN 



Code Meaning 



N 



alien 

native born 
naturalized 



Date of Hire 

Month of Hire 

Year of Hire 

Rate at Time of Hire 

Number of 
Dependents 

Job Description 

Current Pay Rate 

Date Pay Rate 
Established 



HIRE DATE 
HIREMO 
HIREYEAR 
HIRERATE 

DEPEND 

POSITION 

PAYRATE 

PAYDATE 



Month, Day, Year 



DICTNARY MESSAGES 

All specifications on definition cards will be examined. 
Errors will cause output of an appropriate message, pre- 
ceded by a printout of the incorrect record. In the mes- 
sages shown below, the parameter "a" represents the user's 
file name, and "b" or "c" represents the user's field name. 



BAD SYS OR RAD I/O RETURN : nn 



There has been an irrecoverable and unexpected return 
while processing file DICT, where nn represents the BPM 
return code. 



DICTIONARY SPECIFICATION READ ERROR 



There was an error by Sort in reading the specifications. 
Dictnary aborts. 



Month, Day, Year 

Dictionary specifications for this example are shown in 
Figure 3. The resultant dictionary is shown in Appen- 
dix D, Figure 5. 



FILE a DICTIONARY DELETION 



This message records a successful dictionary deletion; it 
precedes the catalog printout. 
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Figure 3. Sample Personnel Master File Specifications 



8 Dictnary Messages 



FILE a FIELD b BOUNDARY OUTSIDE RECORD 



The specified field begins at zero or ends outside the 
boundaries of fhe record. Check the field start position 
and length against total record length. 



1. An illegal alphabetic character combination in file or 
field name has been input. 

2. A duplicate-named field definition card has been input. 

3. A group key field has been specified as a counter field. 



FILE a FIELD b COUNTER NOT BINARY OR HAS 
NO GROUP KEY 



FILE a FIELD b ILLEGAL NEGATIVE SIGN 



Output of this message is due to one of the following causes: A value other than minus or blank has been input. 



1. A fixed field that was tagged as a counter field by a 
multiple field is not binary. 

2. There is no multiple field designated as the group key 
associated with this counter field. 



FILE a FIELD b ILLEGAL AUDIT INDICATOR 



A value other than A or blank has been input. 



FILE a FIELD b ILLEGAL CARD TYPE 



The card type was neither a 1 nor a 2; 2 is assumed. 



FILE a FIELD b ILLEGAL COMMA INSERT 



A value other than C or blank has been input. 



FILE a FIELD b ILLEGAL COUNTER NAME 



Either a nonlegal alphabetic character combination has 
been found, or the given field does not exist in the cur- 
rent dictionary. 



FILE a FIELD b ILLEGAL DECIMAL SCALING FACTOR 



The value is nonnumeric. 



FILE a FIELD b ILLEGAL DOLLAR SIGN INSERT 



A value other than dollar sign or blank has been input. 



FILE a FIELD b ILLEGAL FIELD LENGTH 



Either a nonnumeric value, blanks, or all zeros have been 
found, or the length is too large for the type of field. 



FILE a FIELD b ILLEGAL MULTIPLE ENTRY ORDERING 



Either a nonnumeric value, blanks, or all zeros have 
been found, or there is a gap in the ordering. All further 
multiple-entry definitions will result in errors. 



FILE a FIELD b ILLEGAL NAME 



Output of this message is due to one of the following causes: 



FILE a FIELD b ILLEGAL REPLACEMENT OF 
COUNTER FIELD 



A change from a fixed- to a multiple-type field has been 
defined, but other multiple fields require this field as their 
fixed-field counter. 



FILE a FIELD b ILLEGAL SORT KEY DIRECTION 



J 



If this field is a sort key field, a value other than A or D 
has been found. If this field is not a sort key, a nonblank 
value has been found. 



FILE a FIELD b ILLEGAL SORT KEY LEVEL 



One of the following conditions has occurred: 

1. A nonnumeric value or zero has been found for a fixed 
field, or the key level has already been assigned to 
another field. 

2. A nonblank value other than M has been found for a 
multiple field. 

3. Another multiple-entry field has been previously desig- 
nated as the key to this group. 



FILE a FIELD b ILLEGAL STARTING BYTE POSITION 



A nonnumeric value, blanks, or all zeros have been input. 



FILE a FIELD b ILLEGAL ZERO SUPPRESS INDICATOR 



A value other than Z or blank has been input. 



FILE a ILLEGAL BLOCKING FACTOR 



A nonnumeric value or an embedded blank has been found 
in the user's file blocking factor. Note that an all-blank 
factor is legal, as it indicates a Monitor-formatted file. 



FILE a ILLEGAL BLOCKING OF VARIABLE 
LENGTH RECORDS 



Manage will not process user-blocked records with multiple- 
entry fields. The acceptable forms for variable-length 
records are Monitor-formatted file or user-formatted un- 
blocked file. 



Dictnary Messages 



FILE a ILLEGAL HEADER INDICATOR 



FILE a NAME ILLEGAL 



The indicator was not an F, an H, or a blank. 



FILE a ILLEGAL LOGICAL RECORD LENGTH 



A nonnumeric value, a blank, or all zeros have been found 
when the card is neither a delete nor a list-only option card. 



FILE a KEYS IMPROPERLY SEQUENCED 



Either there is not at least one sort key, or the sort key 
level numbers are not contiguous. 



FILE a MEMORY OVERFLOW 



Output of this message is due to one of the following causes: 

1. There are too many fields for the new dictionary. Over- 
flow may be caused by void entries, or by an excess of 
definition cards being created or transferred from the 
old version. 

2. Not enough working core was available to set up the 
dictionary. This may happen during the update or cat- 
alog phase. 

3. After processing some entries, additional working core 
was not available to hold more standard column headers. 

4. Work areas have become saturated by defining too many 
files on one pass. 

Further analysis of this file's dictionary by Manage is 
inhibited. 



There is an illegal alphabetic character combination in 
the file name. 



FILE a NO DICTIONARY OR TYPE 1 CARD 



One of the following conditions has been found: 

1. An attempt has been made to list a nonexistant 
dictionary. 

2. Field definition cards have been input without a pre- 
vious dictionary to update, or a type 1 file definition 
card is needed to create a new dictionary. 



FILE a NONEXISTENT DICTIONARY 



The file's dictionary is not in file DICT. 



FILE : a TRANSFER OF FIELD : b REQUIRES 
IMPROPEROR DELETED COUNTER FIELD : c 



Multiple-entry field b, in a previous version of the dic- 
tionary, requires field c as its counter. Field c has been 
deleted, changed to a nonbinary type, or made a multiple 
field in the current update. 



MORE THAN 15 MULTIPLE FIELD GROUPS 
IN THIS FILE 



There are too many multiple-entry field groups in the 
file. 



10 Dictnary Messages 



3. FILEUP 



Fileup is the MANAGE program that creates or maintains 
data files that are defined in file DICT. Two methods of 
file creation or updating are available to the user: the 
gang method, and the selection method. 

1. The gang method accepts a single set of data and up- 
dates every record with it, regardless of previous rec- 
ord values. 

2. The selection method accepts data that applies to each 
master record, and updates records according to key 
field selection and requested functions. 

Specifications for an update may be kept permanently in 
the library under the user's account number. This proce- 
dure eliminates the need to submit the same parameters for 
each run, and shortens overhead for successive runs of the 
same files. The transaction file is not limited to card im- 
ages. However, individual fields that are to be handled 
as signed numeric data must be in hardware-compatible 
form. 

Transactions can be sorted by Fileup, if requested. Re- 
placement, algebraic addition, and blank- or zero-fill 
may be specified on individual fields. Other operations 
must be done with user own-code routines. In addition, 
entire records may be selectively deleted or inserted using 
Fileup. 



MASTER FILE DESIGN 



The master file is defined in file DICT. It is the file 
against which all changes are applied. The old version 
of the master file is one of several inputs to Fileup. The 
new version is output incorporating all changes. The Man- 
age dictionary generator (Dictnary) imposes the following 
constraints on design of the master file: 

1. Each file must have at least one sequence key. 

2. Each multiple group must have a group selector key 
field. 

To ensure file sequence, Fileup will not act on the se- 
quence key fields or their overlays. Therefore, any 
changes to these fields must be made by deleting the ori- 
ginal version of the record and inserting a complete new 
record as a separate transaction (see record function codes) 



The counter field that controls the number of occurrences 
in a group is automatically maintained by Fileup and must 
not be cited in the update specifications. 

Selection of an occurrence is made by identifying a group 
selection key value (not by its place or order of occurrence). 
Group selection keys can only be deleted, inserted / or re- 
placed. The replacement option identifies the occurrence 
so that action on other fields within the group can take 
place. Usually, group selection keys will be associated 
with complete group occurrences rather than with individ- 
ual values. Once a group selector key is established at a 
given level of occurrence, all multiple-entry fields within 
the group will continue to exist until the group selection 
key field is deleted. Conversely, if a group key is deleted, 
the entire group of fields at that level is also deleted. Any 
change involving a multiple field must be tied to a group 
selector key value as well as to the record sequence keys 
for complete indentification to the occurrence level. 



TRANSACTION FILE DESIGN 



The transaction file is defined by the specifications to 
Fileup with the file and field names serving as the link to 
the dictionary definition of the master file. The transac- 
tion file may contain interleaved records of more than one 
design. Though each record will have more than one field, 
the record will, hereafter, be called "a transaction. " 
Transactions will contain the changes to be applied to the 
master file within the limits set under "Master File Design" 
above. Except for the following requirements, transaction 
design is up to the user, including overlaying and redefini- 
tion of field positions. 

1. All transactions must be the same length. 

2. All sequence key fields of the master file must be in 
every transaction. 

3. If transactions are of more than one design, a trans- 
action code field must be defined to identify the vari- 
ous formats. 



If a combination of delefe-a-record, insert-a-record, 
or change-a-record functions is required, a record 
function code field must be defined to identify the 
function of each transaction as a whole. 



Fileup will act on variable-length records which meet 
the design requirements of the dictionary generator 
(Dictnary). Each multiple group must have one of the 
fields within the group designated as the group selector 
key. This field must have unique values so as to identify 
individual occurrences of the group even though Fileup 
is not concerned with the sequence of all occurrences. 



5. All transactions must have sequence key fields, trans- 
action code field, and record function code field in 
the same locations. 



Transaction codes and record function codes will be 
considered alphabetic (EBCDIC). 



Fil 



eup 
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Transactions are not restricted to card images. Record 
function codes for records are shown below in their order 
of evaluation. 

Code Meaning 



Delete a record if all keys match. 

Insert record in proper sequence if keys do 
not match. 

Update a record if all keys match. 



If key conditions are not as expected, the transaction rec- 
ord is listed and no change is made to the master file. If 
no record function code is specified, the type of run will 
determine the default condition. A creation run will de- 
fault to an insert function, while an update run will 
default to an update .function. 

A transaction must be input for each occurrence level of 
a multiple field. Sequence key values must be repeated 
and the corresponding group selector key field value must 
be present for occurrence identification. 



AUDIT FILE DESIGN 

Audit fields may be defined in the dictionary so that 
master file changes can be monitored. An audit file will 
be created if changes are made affecting an audit field. 
The file will contain the entire record from the old input 
version of the master file. Specific causes are given below. 

1. An update to one or more audit fields in a record. 

2. Deletion of a record due to the record function code. 

3. Deletion of a record on a return from own-code (see 
below) to the delete function. 

USER OWN-CODE 



Fileup can be incorporated in the user's library as a num- 
ber of special purpose programs with user own-code modules. 
The user assembles his program as independent relocatable 
object modules and then builds an overlay structure (with 
his new load module name) that merges his program with 
the Fileup root segment (FILEUPO). This results in a unique 
program for that particular file maintenance task. The user 
may then call out any desired version and specify links to 
his own-code at any or all of the following points: 

1. Before opening either version of the master file. 

2. Immediately before writing the output master file or 
volume header, and after reading the input master 
file or volume headers. 

3. Immediately after reading a logical record from 
the input master file. (A delete record return 
is provided. ) 



4. Immediately after matching a master record to a trans- 
action, with access to both records. 

5. Immediately before writing a logical record on the out- 
put master file regardless of transaction changes. (A 
delete return is provided.) 

6. Before closing the transaction, the audit, the input 
master, and the output master files. 

Trailers will not be handled by Fileup; hence, they must be 
processed by user own-code. 

Specifying user own-code accesses on the file update card 
will cause the link to be attempted. If the link is not suc- 
cessful, an immediate abort will occur. 

External entry points for own-code to be defined in 'the 
user's program are given in explanations of Fileup specifi- 
cation cards, below. 

A file update may reference: 

1. Specifications 

2. Transactions 

3. DICT 

4. Old master 

5. New master 

6. Audit 

The specifications and DICT files will be read and inter- 
preted first. Fileup will then reference the transactions, 
audit, and old and new master files. Therefore, a maximum 
of four DCBs wili be active at one time; a user with linked 
own-code routines may use his own DCBs. 

FIELD CONVERSION 



Fileup will convert transaction data to the correct type 
for the master file. However, the user must be aware of 
certain size limitations. For example, the user is respon- 
sible for correctly scaled inputs (integer is assumed). 
Table 2 below shows transaction field size limitations 
and restrictions. 



An alphabetic transaction field may not be all blank 
when a zero numeric value is intended. At least one 
right-most zero must be explicitly present. Note the 
use of the conditional replacement function code to 
bypass this restriction. 

When an alphabetic transaction field contains negative 
values to be converted to packed decimal or binary form, 
it must have an overpunch (11-zone punch) over the 
least significant digit. 
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Table 2. Transaction Data Field Sizes 



Transaction Field 
Data Type 


Master Field Data Type 


Alphabetic (EBCDIC) or text 


Binary 


Packed Decimal 


Alphabetic (EBCDIC) 
or text 

Binary 

Packed Decimal 


Equal. 

Maximum transaction 
field byte length is 
4 bytes. ft 

Maximum byte length is 

equal to 

(master byte length/2) + l. fl " 


Maximim transaction 
field size is 10 bytes. 

Less than or equal to 
master length. 

Maximum transaction 
field size is 6 bytes. 


Maximum byte length is equal to 
(master byte length x 2) -1. 

Maximum transaction field byte 
length is 4 bytes. ^ 

Less than or equal to master 
length. 


An arithmetic overflow trap may occur during the actual update. Some values fall within the maximum transaction field 
size, but overflow the maximum hardware binary value (2^ - 1) upon conversion. The run will be aborted. 

Arithmetic truncation of significant data may occur if the master field is not large enough to contain the converted 
value. The run will be aborted. Numeric transaction fields may be smaller than the master field. An automatic left- 
zero fill occurs. 



CALLING FILEUP 



Input for a Fileup run may consist of the following cards: 

1. Fileup processor call card. 

2. File update card. 

3. Field update cards. 

Fileup will call Sort to read (via the M:SI DCB) and sort the 
specifications by card type function, transaction code, and 
starting byte position. If no errors exist in the specifica- 
tions, the actual update occurs. 

If input/output errors are encountered during a run in either 
the old master file or the transaction file, the record will 
be listed on the logging device along with an error message 
telling which file was in error. Any sequence error in the 
master or transaction files or illegal hardware arithmetic 
operation will immediately terminate the job. On input/ 
output errors, the user has the option of either ending the 
run, or bypassing the error and continuing the update. If 
continuation is elected, a sort of the transaction file will 
also allow continuation on input/output errors. Assign- 
ments must be made for both master files and the audit files. 
An assignment for the sorted transactions may be made but 
will default to the RAD. No file releases may be entered 
on the assignments, but may be done later via the File Man- 
age program. 

If requested, the transaction file will be sorted according 
to key fields, record function codes, and transaction code. 
Therefore, changes with the lowest record function code and 
transaction code for a given master record will be performed 
first. Gang transactions are sorted along with other trans- 
action types. They will not be acted upon until their key 



values bring them in sequence with the master file. (Note 
that multiple fields cannot be ganged.) In addition, the 
user must ensure that only one record for each gang trans- 
action is input, since a later record of the same transaction 
type will replace previously input values. 

During the processing of a transaction, the fields will be 
processed in order of their starting byte in ascending order. 
More than one transaction may apply to a master field. 

During creation of a new record, Fileup will preset alpha- 
betic fields to blanks (hex. 40), binary fields to zero 
(hex. 00), and packed decimal fields to zero (hex. 00C). 
Note that this is for computational convenience only, and 
does not create a null state. If not updated by the user, 
such preset fields will be treated as valid data by Retrieve 
and Report. Undefined areas will be preset to binary zero. 

Formats for Fileup run cards are given below. An asterisk 
(*) after column numbers indicates that the field is optional, 
Register use for own-code linkage is given in Appendix C. 

The Fileup processor is called from the System Library with 
a Fileup call card. Its form is shown below. 



FILEUP 



fCl 


r \\\ 




A 


u| \ 




k\ 





/here 



! FILEUP is required as shown, starting in 

column 1. 



Calling Fileup 13 



indicates the type of run. One of the fol 
lowing codes must be in column 11. 



Columns Description 



Code 

C 

U 

4 



L' 

A 

ID. 



Meaning 

Create a new file. 

Update an existing file. 

Delete the library, where £ repre- 
sents a blank character. 



is the library action code. One of 
the following codes must be in col- 
umn 13. 

Code Meaning 



L Specifications are to be ob- 

tained from the library under 
the name in columns 14 to 17. 

A Specifications are to be ob- 

tained from the M:SI device 
and are to be added to the 
library under the name in 
columns 14 to 17. 

D Delete the library specifi- 

cations named in columns 
14 to 17. No new specifi- 
cations should follow this 
processor call card. (When 
D is used, column 11 should 
be blank.) 

name contains the library name 

(left-justified) of the specifica- 
tions in columns 14 to 17. This 
field should be blank if column 
13 is blank. 

& Specifications are to be obtained 

from the M:SI device and are not 
to be saved. 

If a change to library specifications is made, the entire 
set must be input via the M:SI device. 

The specifications below define the format of the input 
transaction file described by the type 3 card. Each trans- 
action record format is derived by Fileup by grouping to- 
gether all the type 4 cards with the same transaction ID 
code. The sequence key fields in the transaction records 
are defined only once, and are assumed to apply to every 
type of transaction record. The transaction fields are 
given the same name that is used in the dictionary for the 
master file to permit association of new data with the old. 



FILE UPDATE CARD 



See Figure 4 for a diagram of the file update card. 



3-10 



12-15 



17-19* 



21' 



23" 



24" 



25" 



26" 



27" 



28" 



30* 



32" 



34-37* 



3: identifier for a file update card. 

Master file name: name of the file being 
updated. 

Transaction record length: logical rec- 
ord length in the transaction data file. 

Transaction blocking factor: blocking 
factor for user-formatted transaction 
file. A blank indicates a Monitor- 
formatted file. 

Transaction file header: for user- 
formatted files only. An H indicates 
that the header label is to be skipped. 
An F signals the presence of one or 
more labels followed by an EOF mark. 

Own-code on opening: a Y specifies 
own-code linkage to FUPOP before 
opening any files. 

Own-code on header: a Y specifies 
own-code linkage to FUPHD for val- 
idating an input user header, and for 
creating an output user header. 

Own-code on input: a Y specifies own- 
code linkage to FUPIM after reading 
each input master record. 

Own-code on transaction: a Y indicates 
own-code linkage to FUPMT after suc- 
cessfully matching a change transaction 
to an input master record. 

Own-code on output: a Y signals own- 
code linkage to FUPOM before writing 
each output master record. 

Own-code on closing: a Y indicates 
own-code linkage to FUPCL after all 
record processing is complete, but be- 
fore closing any files. 

Sort : an S means sort the transaction file 
according to keys and record function 
code prior to update process. 

I/O error bypass: a B indicates bypass 
any transaction or input master file input/ 
output errors and continue processing. 

Transaction ID starting byte: indicates 
the starting byte (from 0001 to 9999) 
in transactions of the field that deter- 
mines the format r ^ the f^^pc^^fT/^i-. 
This parameter is not needed if there 
is only one transaction format. 
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Maintenance File Definition 
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Figure 4. Manage Fileup Specifications 



Columns Description 



Colur 



39* Transaction code length : byte length 

of transaction code (1 to 4). This 
parameter is not needed if there is 
only one transaction format. 

41-44* Record function code field position: 

byte position of single character record 
function code (0001 - 9999). 

FIELD UPDATE CARD 

See Figure 4 for a diagram of the field update card. 
Columns Description 

1 4: identifier for a field update card. 

3-10 Master file name: name of the file 

being updated. 

12-19 Master field name: name of the master 

field associated with the transaction data. 



21-24* 



26-28* 



30* 



Description 

Transaction starting position: starting 
byte position (0001 to 9999) of trans- 
action data associated with the master 
field. The field must be blank for the 
B or N function (see field function code 
below). 

Transaction field length: byte length 
(001-999) of transaction data. This 
field must be blank for the B or N 
function of the field function code 
(column 32 below). 

Data type: code for type of transaction, 
where A means alphabetic (EBCDIC), T 
means text, B represents binary, and P 
specifies packed decimal data. Note 
that Fileup automatically converts trans- 
action data to the appropriate master 
form as specified in "Field Conversion" 
above. This field is blank for the B or N 
function of the field function code. 
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Columns Description 



32 



Field function code: action code for 
specified transaction fields when 
applied to corresponding master field. 



Code Meaning 

A Algebraic add. Add the trans- 

action field value to the master 
field. Illegal when master field 
is alphabetic or a multiple-entry 
group selector field. 

B Blank fill. Clear master field to 

blanks. No field in the trans- 
action is required for this action. 
Illegal for nonalphabetic fields 
or multiple-entry group selector 
fields. 

C Conditional replacement. If the 

transaction field is not blank or 
zero (depending on data type), 
replace old master field value 
with transaction field value; other- 
wise, take no action. 

D Delete occurrence of the multiple- 

entry group identified by this group 
selection key. Only allowed for 
multiple-entry group key fields. 

G Gang Replacement. Replace mas- 

ter field value with transaction 
field value in every master file 
record from the one identified by 
the sequence keys until the end 
of the file or until the transaction 
is replaced by another. Not al- 
lowed with multiple-entry field. 

I Insert occurrence of multiple group 

identified by the multiple-entry 
group key. Only allowed for 
multiple-entry key fields. 

N Numeric zero fill. Clear master 

field to the correct type of zeros 
for the field type. No field in 
the transaction is required for this 
action. Illegal for multiple-entry 
group key fields. 

R Replacement. Unconditionally 

replace master field value with 
transaction field value. 



Columns Description 

34-37* Transaction code: left-justified value of 

code that identifies type of record asso- 
ciated with this specification. Blank for 
sequence key fields. 



CREATION OF A SAMPLE MASTER FILE 



A system for creating and updating the Amalgamated Cor- 
poration's personnel master file is described below. It 
assumes that a complete record is generated for each 
new employee by keypunching two transactions (coded 
as 10 and 11) from a hiring form. Changes in job title 
and pay rate result in a third type of transaction (coded 
22) which changes an existing master record. The trans- 
action records are shown in Figure 5, and the required 
Fileup definitions in Figure 6. The record function 
code (column 80) would normally be an I in trans- 
actions coded 10 and 1 1, since these represent a new 
hire and should not match a previous master record. Sim- 
ilarly, transactions coded 22 would have a function code 
of U in column 80, since they represent changes to ex- 
isting records. 

The Fileup specifications show that the field in columns 
70 to 74 of the transactions coded 11 is to be placed 
in both the hire rate and current pay rate fields in the 
master. Similarly, the field in columns 64 to 69 of the 
transaction is both the hire date and date of current pay 
rate. However, the submission of a transaction coded 
22 at a later date will change only the current pay rate, 
date of current rate, and job title. 



The Fileup specifications show either field function 
codes of S, which identifies the transaction file key 
fields, or C, which specifies conditional replacement 
of nonblank transaction fields. This permits partial 
transaction records to be generated. Note that se- 
quence key fields are defined only once in the Fileup 
specifications, but apply to all transactions. If any 
item of information is unknown for a new hire, it may 
be left blank in the transaction record and will be ig- 
nored by Fileup. At some later date, the missing in- 
formation may be submitted on a transaction with a 
record function code of U in column 80. This will 
cause Fileup to seek a match between the transaction 
and the previously established master record. At this 
point, Fileup will again ignore any blank transaction 
fields (which by now are already in the file) and will 
pick up only the items being filled in. 



FILEUP MESSAGES 



Sequence key field. This field 
applies to all transaction records; 
therefore, transaction code is not 
applicable. 



me toi lowing messages are output during Fiieup. A 
printout of the incorrect record may accompany the 
message. 
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IDS 




MULTIPLE CARD LAYOUT FORM 


i 


DIV 
1 2 3 


EMPLOYEE 
NO. 

4 5 6 7 8 


T 
R 
A 
N 
S 

C 
O 

D 
E 
9 10 


NAME 
1 12131415161718 19 20 21 222324 25 26 27 28 29 30 31 


STREET ADDRESS 
32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 


CITY-STATE 
52 53 54 55 56 57 58 5960 616263 64 65 666768 69 70 


M 

A 

S R 

ZIP CODE E , 

XT 

A 
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71 7273747576 77 


Si 
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U 
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C 
T 
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O 
N 
S 
80 
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F 
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DIV 

1 2 3 


EMPLOYEE 
NO. 

4 5 6 7 8 


N 

S 

C 
O 

D 
E 
9 10 


SOCIAL SECURITY 
NUMBER 

1 12131415161718 19 


BIRTH DATE 
MO/DY/YR 

20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 


STARTING JOB TITLE 
52 53 54 55 56 57 58 5960 61 


START DATE 
MO/DY/YR 

6263646566 6768 69 


START RATE 
SXX. XXX 

707172 7374 


C 
T 
I 

O 

N 

S 

75 76 77 78 79 B0 
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NO 


S 

C 
O 
D 
E 
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CURRENT RATE 

DATE 

MO/DY/YR 


CURRENT 
PAY DATE 
SXX.XXX 




CURRENT JOB TTTLE 




C 
T 
I 
O 






1 2 3 


4 5 6 7 8 


1 1213141516 


1718192021 


22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 


42 4344 45 46 47 48 49 50 51 


N 

S 

525354 5556 57 58 596061626364656667 6869 70 7172 7374 7576 7778 79 30 
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9 10 
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Figure 5. Sample Transaction Records 



ALL KEYS NOT SPECIFIED 



ILLEGAL BOUNDARY- FIELD xx 



Either not all of the master file sort keys have been identi- 
fied in the transaction record, or one or more have been 
rejected due to other errors. 



The specified transaction field, as defined by its starting 
position and length, is outside the bounds of the record. 



ARITHMETIC TRAP IN THE FOLLOWING 
TRANSACTION RECORD 



ILLEGAL CARD TYPE 



An arithmetic overflow or an illegal decimal digit trap has 
occurred during a field conversion operation. A mandatory 
abort occurs. 



The card type code is not 3 or 4, or multiple type 3 cards 
were found. 



FILEUP SPECIFICATION READ ERROR 



ILLEGAL DATA TYPE - FIELD xx 



An error has occurred while sorting the specification 
input through the M:SI DCB. A mandatory abort 
occurs. 



The data type code must be A, B, P, or T. If the field func- 
tion code specifies a blank or numeric zero fill (B or N), 
it must be blank. 
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ILLEGAL FUNCTION-FIELD xx 



ILLEGAL GROUP KEY MATCH 



An error has been found in rhe field function code, which 
is subject to the following restrictions. 

1. If the field is a master sort key, the field function 
code must be S. 

2. If the transaction field is defined as text, or if the 
master field is defined as alphabetic or text, the 
field function code may not be A (addition). 

3. If the master field is defined as binary or packed 
decimal, the field function code may not be B 
(blank fill). 

4. If the master field is a multiple-entry field, the field 
function code may not be G (gang replacement). 

5. If the master field is a multiple-entry field and: 

a. a group selector key, the field function code 
must be I, D, C, or R. 

b. not a group selector key, the field function 
code must not be I or D. 



One of the following conditions has been found. 

1. An insert has been requested for a multiple-entry field 
but the group key to be inserted already exists in the 
master record. 

2. A delete, replace, or update group is requested but the 
group key does not exist in the master record. 



ILLEGAL HEADER INDICATOR 



Either the transaction file header indicator is not H, F, or 
blank, or is F for a Monitor-formatted file. 



ILLEGAL I/O ERROR CODE 


The 


input/output error bypass indicator is not B or 


blank. 


ILLEGAL ITEMS SPECIFIED - FIELD xx 



The transaction field starting byte, length, and data type 
must be blank when the record function code is B or N 
(blank or numeric zero fill). 



3U3 

SIGMA MANAGE FILEUP SPECIFICATIONS 

Maintenance File Definition 
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Figure 6. Sample Fileup Specifications 
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ILLEGAL LIBRARY CODE 



The library action code in column 13 of the Fileup pro- 
cessor call card is subject to the following conventions. 

1. Must be L or A if library name is specified. 

2. Must be D if run type is blank and library name is specified. 

3. Must be blank if library name is blank. 



ILLEGAL LIBRARY NAME 



The library name in columns 14 to 17 of the Fileup pro- 
cessor call card must be blank if the library action code 
is blank. 



ILLEGAL MASTER LENGTH - FIELD xx 



The master field is greater than 31 bytes and therefore can- 
not be completely filled by converting the numeric trans- 
action field to EBCDIC. 



ILLEGAL NAME - FIELD xx 



Either the master file name in a type 4 card is different 
from the name in the type 3 card, or the field name can- 
not be found in the dictionary of the master file. 



ILLEGAL OWN CODE INDICATOR - CLOSE 



ILLEGAL OWN CODE INDICATOR - HEADER 



ILLEGAL OWN CODE INDICATOR - INPUT MASTER 



ILLEGAL OWN CODE INDICATOR - OPEN 



ILLEGAL OWN CODE INDICATOR - OUTPUT MASTER 



ILLEGAL OWN CODE INDICATOR - TRANSACTION 



The specified own-code indicator is not Y or blank. If 
the dictionary indicates a master file header, own-code to 
process the header is always required. If no header is 
specified in the dictionary, own-code for headers is not 
allowed. 



ILLEGAL RECORD FUNCTION CODE 



A record function code field is not I, U, or D. 



ILLEGAL RECORD FUNCTION CODE MATCH 



One of the following conditions has been found: 

1. There is no key match between the V or D-fype trans- 
action record and a master record during an update run. 



2. There is a match between the I-type transaction rec- 
ord and a master record during an update run. 

3. V and D function codes were encountered in a crea- 
tion run without a preceding I-type record. 



ILLEGAL RECORD FUNCTION CODE POSITION 



The record function code position must be either all numeric 
(nonzero) or all blank, and must lie within the bounds of the 
transaction record. 



ILLEGAL SORT INDICATOR 


The 


transaction file sort indicator is 


neither 


S nor 


bl 


ank. 




ILLEGAL SPECIFICATION - 


- FIELD 


XX 







Output of this message is caused by one of the following 
two conditions. 

1. A transaction data field overlaps a master sequence 
key field or a multiple-entry counter field. 

2. A master key field or multiple-entry group selector 
key has been specified more than once on the same 
transaction record. 

3. A multiple-entry counter field has been specified on 
a transaction. 



ILLEGAL START POSITION - FIELD xx 



The transaction field starting position must be either all 
numeric (nonzero), or blank if the field function code 
specifies a blank or numeric zero fill (B or N). 



ILLEGAL TRANSACTION BLOCKING FACTOR 



The transaction blocking factor must be either all numeric 
(nonzero) or blank if the transaction file is Monitor-formatted. 



ILLEGAL TRANSACTION CODE 



The value in the transaction code field does not correspond 
to any value supplied in the transaction specifications to 
Fileup. 



ILLEGAL TRANSACTION CODE POSITION 



Output of this message is caused by one of the following 
conditions: 

1. The starting byte or length of the transaction identifi- 
cation code is not all blank or all numeric. 

2. The transaction identification code length is greater 
than 4 bytes. 

3. The transaction identification code field does not fall 
within the boundaries of the transaction record. 



Fileup Messages 19 



ILLEGAL TRANSACTION CODE SPECIFIED - FIELD xx 



Output of this message is caused by one of the following 
conditions: 

1. The specified transaction code is longer than the code 
length shown in column 39 of the type 3 card. 

2. The transaction code must be blank if no code posi- 
tion is shown in columns 34 to 37 of the type 3 card. 

3. The transaction code must be blank if the field func- 
tion card is S (sequence key field). 



ILLEGAL TRANSACTION LENGTH-FIELD xx 



Output of this message is caused by one of the following 
conditions: 

1. The transaction field length is not all numeric (non- 
zero), or blank if the field function code specifies a 
blank or numeric zero fill (B or N). 

2. The transaction field length exceeds the maximum 
permitted for the type of data, where unpacked dec- 
imal fields may not exceed 31 bytes, packed decimal 
fields may not exceed 16 bytes, and binary fields may 
not exceed 4 bytes. 

3. The transaction field length violates the rules of con- 
version to master field data. 



ILLEGAL TRANSACTION LOGICAL RECORD 
LENGTH 



The transaction record length either contains a nonnumeric 
character or is zero. 



ILLEGAL RUN TYPE CODE 



Either the run type code in column II of the Fileup pro- 
cessor call card must be U or C, or it must be blank if a 
specification library entry is to be deleted. If nonblank, 
a library deletion will not be performed. 



INITIALIZATION COMPLETE-READY 
TO PROCESS FILES 



This message signals the completion of an error-free 
initialization. 



IRRECOVERABLE I/O ERROR xx 



An irrecoverable input/output error has occurred, where 
xx represents the BPM error code. The job will be con- 
tinued or aborted according to Fileup option. 



LABEL END MARK REQUIRES DEVICE ASSIGNMENT 
FOR INPUT MASTER 



LABEL END MARK REQUIRES DEVICE ASSIGNMENT 
FOR OUTPUT MASTER 



LABEL END MARK REQUIRES DEVICE ASSIGNMENT 
FOR TRANSACTION 



A header, consisting of one or more records ending with a 
file mark, is indicated for the named file, but it is not as- 
signed to a device. Processing the file mark requires a 
device assignment. 



MANAGE FILE UPDATE LIBRARY: bb FILE: cc 



This message precedes the listing of specifications read 
through the M:SI DCB, where bb is the library name of 
the Fileup processor call card, and cc is the master file 
name from the type 3 card. The message names the master 
file to be processed, and the name that is associated with 
the new specification library entry, if any. 



MASTER FILE SEQUENCE ERROR 



An out-of-sequence condition has been detected in the 
master file, necessitating a mandatory abort. 



MULTIPLE FIELD PRESENT WITHOUT ITS GROUP 
KEY THIS TRANSACTION 



One or more members of a multiple-entry group have been 
defined for the indicated transaction record, but the group 
selector key is missing. Any transaction record containing 
a multiple-entry group field must also contain a group 
selector key. 



NONEXISTENT DICTIONARY 



Manage was unable to find the required master file dictio- 
nary under the specified name and current account number. 



NONEXISTENT LIBRARY 



Manage was unable to find the specification library entry 
under the name indicated on the Fileup processor call card 
and the current account number. 



NO SPECIFICATIONS ALLOWED FOR GIVEN 
LIBRARY ACTION 



Transaction specifications are not expected if the Fileup 
processor call card indicated a library deletion. The speci- 
fications will be validated but not saved, and the run will 
be aborted. 



NO SPECIFICATIONS INPUT 



Specifications were not available through either the M:SI 
DCB or the library. 



L 



OBSOLETE LIBRARY 



The specification library entry has been made obsolete 
by the generation of a new master file dictionary. The 
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complete set of transaction specifications must be revali- 
dated and added to the specification library. 



OWN CODE LINKAGE UNSATISFIED - CLOSE 



OWN CODE LINKAGE UNSATISFIED - HEADER 



OWN CODE LINKAGE UNSATISFIED - 
INPUT MASTER 



OWN CODE LINKAGE UNSATISFIED - OPEN 



OWN CODE LINKAGE UNSATISFIED 
OUTPUT MASTER 



OWN CODE LINKAGE UNSATISFIED - 
TRANSACTION 



The own-code linkage named is not satisfied, but is re- 
quested in the Fileup specifications. 



TRANSACTION CAUSES MASTER RECORD TO 
EXCEED MAXIMUM SIZE 



TRANSACTION FILE SEQUENCE ERROR 



An out-of-sequence condition has been detected in the 
transaction file, necessitating a mandatory abort. 



TRANSACTION FILE SORT ERROR 



The input transaction file could not be sorted successfully. 

The messages shown below give the specified record counts 
after the successful completion of a Fileup run. 



MASTER RECORDS INPUT xxxxxx 



MASTER RECORDS ADDED xxxxxx 



MASTER RECORDS DELETED xxxxxx 



MASTER RECORDS OUTPUT xxxxxx 



A multiple entry group insertion transaction has been found 
which causes the master record to exceed the maximum 
logical record length specified in the Dictionary. The 
transaction is listed and rejected. A Dictionary update 
run is required to indicate a higher maximum length. 



AUDIT FILE SIZE xxxxxx 



TRANSACTION RECORDS IN xxxxxx 
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4. RETRIEVE 



The Retrieve program extracts data from a data base file 
according to user-specified search criteria. Retrieve ana- 
lyzes the user's specifications to generate the code neces- 
sary to satisfy the request. Requests are expected to be 
batched. A maximum of 99 requests will be processed with 
a single reading of a data base file. Retrieve performs the 
following operations: 

• Reads the retrieval /report specifications from the 
standard input device (M:SI). 

• Transmits the report specifications to the Report 
program. 

• Interprets the retrieval search and extraction 
specifications. 

• Reads file DICT, which describes the file from which 
the requested information is to be extracted. 

• Generates a set of routines that satisfy the request. 

• Formats the intermediate output file records and trans- 
mits these formats to the Report program. 

• Executes the retrieval routines, which extract the 
requested information from the selected records of the 
request file. 

• Writes the extracted data into an intermediate output 
file for further processing by the Report program or by 
a user program. 

• Saves request specifications in the Manage request li- 
brary, if desired. 

• Obtains a standard request from the request library, if 
specified. 

The Manage user controls the retrieval function by specify- 
ing the following: 

1. Name of the file which contains the required 
information. 



File matching is subject to the following constraints: 

1. Both files must have the same key structure to the level 
of the file with the fewest key fields, as in, 



Primary File 


Sec 


ondary File 


Key Field Name 


Key 
1 


Field Name 


1 Div 


Division 


2 Location 


2 


Location 


3 Shop Number 


3 


Shop Number 


4 Equipment Class 







2. Key fields at the same level must be of the same data 
type, that is, both binary, alphabetic, or packed 
decimal. 

3. The sequence of both files must be the same, that is, 
both ascending or both descending. 

4. Key fields at the same level are not required to have 
the same field name or length. If the lengths are dif- 
ferent, the following comparison procedure will be 
followed: 

a. Alphabetic fields will be matched from left to right, 
using the length of the shorter of the two fields. 

b. The shorter of two numeric fields will be left zero 
filled and matched to the length of the longer field. 

Record selection criteria are presented to the Retrieve 
program as search specifications. A record is selected when 
the criteria are satisfied. Specifications may range from a 
"bypass search", which will yield information from every 
record in the file, to the specification of a unique key value 
criterion, which is satisfied by oniy one record in the en- 
tire file. 



Output specifications name the field(s) whose contents are 
required by the user. It is possible to request the contents 
of one field in a single record in the file, the contents of 
every field in every file record, or anything between these 
two extremes. 



2. Criteria to be used in determining those records in the 
request file from which information is to be extracted. 

3. Information to be extracted from the selected records. 

Additionally, the user may specify whether he wishes the 
extracted information to be formatted and listed as hard 
copy, or whether he requires an intermediate file for further 
processing by a non-Manage program. 

The user may specify that data from two files is required to 
satisfy his request. This procedure is ai lowed when the two 
files have the same key (at least to the level of the file with 
the fewest key fields), and permits positive association of 
related records. 



SELECTION CRITERIA 

The user describes his record selection criteria as a list of 
two-term relationships separated by one of the logical 
operators AND and OR. A maximum of 20 consecutive 
AND criteria will be accepted in Retrieve in any given 
request. Note that an intervening OR criteria restarts 
this count. A criterion is specified as a relationship 
between a field in the file, and one of the following: 

1. A different field 

2. A constant 

3. The result of an evaluated arithmetic expression. 
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The relational operators that may be used are given below. 

Operator Meaning 

EQ Equal to 

LS Less than 

GR Greater than 

NE Not equal to 

GE Greater than or equal to 

LE Less than or equal to 

Numeric fields that are being compared must be of the 
same data type, that is, both binary or both packed decimal. 

ARITHMETIC EXPRESSIONS 

An arithmetic expression consists of two terms connected by 
an add, a subtract, a multiply, or a divide operator. The 
terms may be 

1. Two separate fields 

2. Evaluated results from two previously specified 
expressions 

3. A field and an expression result 

4. A field and a constant 

5. An expression result and a constant. 

Note that if two fields are specified, they must be of the 
same data type, that is, both binary or both packed decimal. 
Expressions are evaluated and saved to be used as search 
criteria or in subsequent expressions and may be included in 
the Retrieve output data. The size of a saved expression 
is always set at 15 digits plus an algebraic sign if it is 
packed decimal, or 64 bits if it is binary. Some sample 
arithmetic expressions are given below. 



Arithmetic 
First Term Operator 

Field 1 + 



Field 3 
Field 4 

yyy 



Arithmetic 
Second Term Result Name 



/ 



Field 2 



+ 15.7 



+ 37 



yyy 



Although an expression consists of an arithmetic operation 
involving only two terms, it is possible to build up expres- 
sions of almost any desired complexity by successive itera- 
tions of this process. For example, to evaluate 



X=A + i^£-E 





Arithmetic 




Arithmetic 


First Term 


Operator 

* 


Second Term 


Result Name 


C 


+ 2 


Tl 


B 


+ 


Tl 


T2 


T 2 


/ 


D 


Tl 


Tl 


- 


E 


T 2 


A 


+ 


T2 


X 



set up the problem as follows. 



where X, Ti, and T2 are internal storage fields to be de- 
fined at run-time by the Retrieve processor. 

Arithmetic expression results are made available for all sub- 
sequent comparisons and may be included in the retrieved 
output data. 

Retention of fractional significance (number of decimal 
places) in arithmetic-expression results is as follows: 

1. Addition and subtraction: the result is carried to the 
greatest number of decimal places in either term. 

2. Multiplication: the result is rounded to the greatest 
number of decimal places in either term. 

3. Division: the result is truncated to the greatest number 
of decimal places in either term. 

Since arithmetic expressions may be randomly interspersed 
with the criteria in a request, it is not always apparent 
which expressions will be evaluated under a given set of 
conditions. Retrieve always begins with the first line of a 
request and processes the following lines in consecutive 
order. However, the request contains implied branch points 
that are governed by the contents of the record being ex- 
amined. There are two conditions that cause portions of 
the request to be ignored. They are: 

1. A comparison that is true, that is, one that satisfies 
the conditions imposed by the user, and that has OR 
as a logical connector. In this case, the record will 
be selected, and all subsequent request lines will be 
ignored. In the example of Figure 7, lines 01 and 02 
are always evaluated, but if line 03 is true, all further 
lines will be ignored for that data record. 

2. A comparison that is false, that is, one that does not 
satisfy the user's conditions, and that has AND as a 
logical connector. In this case, the next line to be 
evaluated or compared will be the line following the 
next OR connector, if there is another OR in the re- 
quest. If there are no more OR connectors before the 
END connector, the record will be rejected. In the 
example of Figure 8, if line 01 is false, then lines 02 
and 03 are inconclusive and are skipped. Line 04 will 
be compared but may be in error since NEW % may not 
have been evaluated. 

As long as neither of these conditions obtains, evaluation 
of arithmetic expressions and examination of comparison 
criteria will continue in sequence until the END connector 
is reached. 
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Figure 7. Sample Comparison with OR Connector 



SHS 

SIGMA MANAGE RETRIEVAL SPECIFICATIONS 



12 3 4 5 6 7 



VCQPlTQ 



^LN Jfi j ft 



LINE 
NO. 




FIRST TERM 




OPER 




OPERAND 




LOG. 
CON. 




FIELD OR 
ARITHMETIC 
RESULT NAME 




COMP 

OR 
ARITH 
OPER 




LITERAL CONSTANT VALUES 


AND 
OR 
EXP 
END 


FIELD OR ARITH. 1 | ARITHMETIC 
RESULT NAME/LITERAL] | RESULT NAME 


8 9 


10 


11 12 13 14 15 16 17 18 


1? 


20 21 


22 


23 24 25 26 27 28 29 30,31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 5] 52 53 54 55 56 57' 58 59 60 61 62 63 64 65)66 67 68 69 70 71 72 73 


?4 


75 76 77 


0,1 




cr,p,E,M,eE;Q 




FG 








M,3> 


0,2 




i\,E,*lo,a6 , 




/* 




XdTaao ,!,,,, ,,,,,,,,,,, , , , i^emI,^ , , , 




Er,y r p 


0,3 




DXtf.lSLttW 




£® 








Qto 


0,4 
















£M 












h 









Figure 8. Sample Comparison with AND Connector 



DATA FORMATS 

Some of the significant characteristics of the data base file 
from which data can be retrieved are given below. 

1. Variable-length records are permitted. A variable- 
length record differs from a fixed-length record in 
that a variable-length record will contain one or 
more multiple-entry fields. These fields contain a 
list of different values which the field has assumed or 
might assume at different times or under different 
conditions. 

2. Data base fields may be binary integer, packed deci- 
mal, or alphabetic (EBCDIC). 

3. A binary field must be from 1 to 4 bytes long and must 
lie within byte boundaries. 



4. Variable-length fields are not permitted. A given 
field is the same size in every record of the file. How- 
ever, in the case of a multiple-entry field, the fixed- 
length value may occur a variable number of times. 

5. A counter field in the root segment must be specified 
for every multiple-entry field. This binary field con- 
tains the number of occurrences of the multiple-entry 
field in any given record. One field may serve as a 
counter for several multiple-entry fields. 

CALLING RETRIEVE 

The Retrieve program uses the Batch Processing Monitor 
for file services and for overlay loading, and Dictnary to 
determine the format of the request fiie. Retrieve passes 
those parameters that describe the report format to Report, 
as well as the intermediate file data and intermediate file 
format information. 
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Input for a Retrieve run consists of the following cards: 

1. Retrieve processor call card. 

2. General request specification card (type A). 

3. Title and heading card (type B). 

4. Retrieval specification card (type C). 

5. Retrieved output card (type D). 

Up to 99 requests (sets of A, B, C, and D cards) may follow 
the Retrieve processor call card. 

After the processor call card, general request specifications 
are input on card types A and B. Following these may be 
a list of retrieval specifications (card type C). These 
specifications will define record selection criteria and 
arithmetic expressions, if a selective search is required 
(that is, search mode in column 30 of card type A record 
is S). Retrieval specifications typically contain: 

1 . One of the following conditions: 

a. The name of a field, which is a record selection 
criterion, and a constant or list of constants against 
which the criterion field value is to be compared. 

b. The name of a criterion field and the name of 
another field in the record, the contents of which 
are to be compared against the criterion value. 

c. The two terms of an arithmetic expression, which 
can be a combination of field names, constants, 
or the results of previously evaluated expressions. 

d. The name of a previously defined arithmetic expres- 
sion result, and any othercriterion field or constant. 

2. One of the following relational operators for a crite- 
rion expression: 

Operator Meaning 



EQ 


Equal to 


LS 


Less than 


GR 


Greater than 



NE Not equal to 

GE Greater than or equal to 

LE Less than or equal to 

3. One of the following algebraic operators for an arith- 



metic expression: 




Operator 


Meaning 


+ 


Add 


- 


Subtract 


* 


Multiply 


/ 


Divide 



4. One of the following: 

a. A logical operator that connects two criterion 
statements (AND, OR). 

b. An expression identifier (EXP). 

c. An end identifier (END). 



The next input form is the retrieved output card (type D). 
Although this form contains a great deal of information, 
the Retrieve program is concerned only with the names 
of the fields that are to be extracted from the selected 
records, and the order in which these fields are listed by 
Report. The order of listing the extracted field names de- 
termines the format of the intermediate file record. Each 
request in a given batch generates its own specific output 
format. In a batch of 99 requests, the maximum record 
size that can be listed is 1648 bytes (412 words). The max- 
imum increases by four bytes for each request under 99 in 
a batch. These specifications are brought in during Retrieve 
and validated there, so as to maintain a single entry point 
of parameters into the system. 

Every request will undergo a thorough validity check. Di- 
agnostics will be returned to the requestor to indicate such 
conditions as: 

1. Required parameters missing or in the wrong place. 

2. A field named in the request not defined for the re- 
quest field. 

3. A field mode inconsistent with its use. 

If errors are found in a request, the request is aborted after 
identifying as many of the errors as possible. If the dictio- 
nary for the request file is unreadable, the entire run is 
aborted. 

Formats of these cards are given below. In the following 
card definitions, an asterisk (*) after column numbers indi- 
cates that the field is optional. 

The format of the Retrieve processor call card is given below. 

/l RETRIEVE 



where ! RETRIEVE is required as shown, starting in column 1. 

GENERAL REQUEST SPECIFICATION CARD 

See Figure 9 for a diagram of the general request specifica- 
tion card (type A). 



Columns Description 



1-4 Request number: any four characters identifying 

all the specification records that pertain to a 
given request. 

6 A_: identifier for a general request specification 

card. 

8 Library request: an L means that the Manage 

request library should be searched for specifi- 
cations previously saved under this request num- 
ber. The library specifications will constitute 
the request to be processed. The only changes 
accepted from the current request specifications 
will be reporting system parameters (columns 
36 to 54). 
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SIGMA MANAGE GENERAL REQUEST SPECIFICATIONS 

Retrieval System 



REQUEST NO. 


REQUEST SPEC,F,CAT,ON LIBRARY CONTROL. 




ENTER NAME OF: 


SEARCH MODE 


OUTPUT DISPOSITION 


USER RETRIEVAL FORMAT 






A 


USE MANAGE LIBRARY 
REQUEST SPECIFICATION 


L 


ADD REQUEST 
SPECIFICATION TO 
MANAGE LIBRARY 


A 




PRIMARY FILE TO BE 
SEARCHED 




SECONDARY FILE TO 
BE MATCHED TO 
PRIMARY FILE 


PERFORM SEARCH 


s 


REPORT GENERATOR 


R 


ENTIRE RECORD 


E 


BY-PASS SEARCH 


B 


USER PROGRAM 


U 


SELECTED FIELDS: 
PACKED MULTIPLES 


S 


1 1 1 1 1 1 1 




1 1 1 1 1 1 1 
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V 
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Reporting System 



REPORT FORMAT 


PRINT CONTROL 


PAGE SIZE 




REPORT DATE 


ENTER: 


DETAIL 


D 


SINGLE SPACE 


1 


SPECIAL 





,-PART 


1 


4 


4-PART 


PRINT CURRENT 


D 




NUMBER 

FILE 

RECORDS 

SKIPPED 




OF 

RECORDS 
TO BE 


GROUP DETAIL 


G 


DOUBLE SPACE 


2 


I..-..DEXU" 


1 


2-PART 


2 


6 


6-PART 


DATE ON EACH 


SUMMARY 


S 






„„ 2 "WIDEX„" 


2 




3 






REPORT PAGE 








3 


















36 




38 




40 




42 




44 




46 47 48 49 51 52 53 54 



REQUEST NO. 








Report Title - Text To Be Printed At Top Of Every Page 


f 1b! j 01 | J 
i i i l J I i i i-.-i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i 


1 2 3 4 5 6 7 8 9 10 1112 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 




Title Page - Text To Be Printed On Initial Page 






2 










3 










4 










5 










6 










7 










8 










9 










1 










1 1 










1 2 










1 3 










14 










15 




..-1..J.. l i i I l I i i i i I i i i i i i i i i i l i i i ii i i i i i 



733(3/69) SCIENT 



Figure 9. Manage General Request Specifications 



Columns Description 



8 (cont.) 



10* 



12-19 



21-28 



The saved request will be checked to ensure that 
a change to file DICT has not occurred since the 
card was originally submitted. If a DICT change 
has occurred, the library copy is obsolete and 
must be completely resubmitted. 

If this parameter is left blank, the primary file 
name (columns 12 to 19) and secondary file name 
(columns 21 to 28) parameters must be submitted. 

Add to request library: an A means that this re- 
quest should be added to the Manage request li- 
brary under this request number. If a previous 
request was saved under this number, it will be 
replaced. This parameter is ignored if the user 
intends to validate specifications only. 

Primary file name: an eight-character name of 
the data base file to be searched. If column 8 is 
blank, this parameter is required. 

Secondary file name: an eight-character name of 
a second file to be matched to the primary file. 
If specified, retrieval will take place only when 
primary records have a matching secondary. The 



Columns Description 

matched records may be considered as one logical 
entity, with freedom of selection of any field in 
either record. Primary field names take prece- 
dence over duplicated secondary field names. 
Note that all requests in a batch either must 
specify the same secondary file-matching param- 
eter, or must all be blank. 

30 Search mode : an S means to selectively search 

for records meeting the criteria shown in the re- 
trieval specifications (below). B means to bypass 
the search criteria. Every record will be retrieved 
according to the output specification (type D). 
No retrieval specifications may be included. If 
column 8 is blank, this parameter is required. 

32 Disposition of output: an R means that the re- 

trieved data is to be sent to the Report program. 
U specifies that retrieved records are to be written 
in a separate file for processing by a user program. 
Only one request per batch in Retrieve may specify 
this option. V means validate the request spec- 
ifications, but bypass the actual execution. If 
column 8 is blank, this parameter is required. 



26 General Request Specification Card 



Columns Description 

34* User program retrieval format: one of the codes 

shown below. 

Code Meaning 

E Output the entire record in its orig- 

inal form to a user file for own-code 
manipulation. 

P Permute multiple-entry groups. One 

record is created in the output file for 
every occurrence in each group. Further- 
more, each occurrence is created in an 
output record with all other occurrences 
in all groups to be retrieved. 

S Output selected fields in compact form. 

(This is the option used for files with no 
multiple-entry groups.) The number of 
output records will be equal to the highest 
number of occurrences in any multiple- 
entry group, or a minimum of one record 
if no groups are involved. When all the 
occurrences in a shorter group have been 
output, a null value will be used until 
the longest group has been exhausted. 

36* Report format: one of the codes shown below. 

Code Meaning 

D Print detail records (that is, all records 

retrieved). 

G Print grouped detail lines (that is, the 

key fields for the first in the group). 
Break control fields will print only when 
their values change. 

S Print summary total lines only. 

38* Print control: a 1 means that the report is to be 

single spaced, with double-spaced totals. A code 
of 2 means that the report should be double-spaced, 
and that the totals should be triple-spaced. 



Columns Description 



42' 



40' 



Page size: one of the codes shown below. 



Page 
Code Size 



Print Lines 

Posi- Per 

tions Page 

132 52 



1 14 inches wide, 
1 1 inches long 

2 8-1/2 inches wide, 85 52 
1 1 inches long 

3 11 inches wide, 108 38 
8-1/2 inches long 

Special form, to be 

mounted at list time. 
Print positions and 
total lines are entered 
from the operator's 
console. 

Reports are listed in order by page size, paper type, and 
request number. 



44' 



Type of paper: a code of 1 , 2, 3, 4, or 6 speci- 
fies that the report be printed with other requests 
using a 1-, 2-, 3-, 4-, or 6-part form. Nocode 
is required for a special form (see page size 
above). Note that those reports that require the 
highest number of copies of a given page size are 
printed first. 

Report date: a D means that the current date (in 
the form mon dy 'yr) is to be inserted in a head- 
ing line at the top of each page. 

46-49* Number of records to skip: a four-digit number 
of primary file records to be skipped before this 
request becomes active. Each request in a Re- 
trieve batch may specify a different value. 

51-54* Maximum number of output records: a four-digit 
maximum number of records to be written in the 
output file for this request. 



TITLE AND HEADING CARD 

The title and heading card (type B) is shown in Figure 9. 
This card is optional. 

Columns Description 



1-4 



Request number: must be the same four-character 
identification that appeared in the general re- 
quest specification card (type A) above. 

6 Bj_ identifier for a title and heading card. 

8-9 Line number: a code of 01 identifies a single 

line of text (maximum of 63 characters) to be 
centered at the top of every page except the pre- 
face. A code of 02-99 identifies and sequences 
up to 98 lines of text to be printed on separate 
pages prefacing the request listing. The request 
form is preprinted with 02 to 15. If additional 
prefacing text is required, numbering should con- 
tinue consecutively (16, 17, etc.). 

1 1-73 Text: text lines to be used as a page heading or 

a report preface. 

RETRIEVAL SPECIFICATION CARD 

The retrieval specification card (type C) is shown in Figure 10. 

Columns Description 

1-4 Request number: must be the same four-character 

identification that appeared in the general request 
specification card (type A) above. 

6 C: identifier for a retrieval specification card. 

8-9 Line number: a code of 01 -99 sequences lines of 

retrieval criteria and arithmetic expressions. The 
retrieval search operation and expression evalu- 
ation are carried out in line-number sequence. 
The form is preprinted with 01 to 25. Should a 
single search specification require more than 25 
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Figure 10. Manage Retrieval Specifications 



Columns Description 



8-9 
(cont.) 

11-18 



20-21 

23-30 

or 
23-73 



lines, numbering should continue consecutively 
(26, 27, etc.). 

First term : an eight-character name of the data 
base field (either primary or secondary) to be 
acted upon, or the name assigned to the result of 
a previously defined arithmetic operation result. 

Operator: the logical or arithmetic function to 
be applied to the value defined by the first term 
name. 

Field or expression result name: see the descrip- 
tion of first- term name above. 



Literal constant: one or more literal values. An 
arithmetic expression may specify only one nu- 
meric literal. A retrieval criterion may specify 
multiple literals separated by commas. Muitipie 
literals must all be of the same type and num- 
ber of digits, with the same decimal scaling 
(if applicable). 



Columns Description 

23-73 
(cont.) 



66-73 



If the first term parameter is a packed decimal 
field, a numeric literal consists of a plus or minus 
sign, a maximum of 15 digits, and a decimal point. 
For example, +385. and -16.7 are literal constants. 

If the first term is a binary field, a numeric lit- 
eral consists of an algebraic sign and a maximum 
of 10 digits (maximum value is 2 -1). (Note 
that under these conditions, a numeric literal 
may not contain a decimal point.) 

If the first term parameter is alphabetic, an al- 
phabetic literal will consist of an equal sign fol- 
lowed by up to 49 characters and a trailing 
comma, as in =ABC, . Literals must be alphabetic 
if the first term parameter is alphabetic. 

Arithmetic expression result name: an eight- 
character name to be assigned to the result of 
an arithmetic expression. The resultant vaiue 
takes on the computational characteristics of the 
first term parameter, and may be treated as a 
data base field on all subsequent specification 



28 Retrieval Specification Card 



Columns Description 



66-73 lines. The size of the result is always 15 digits 

(cont.) plus algebraic sign if decimal, or 64 bits if binary. 

75-77 Logical connector: one of the connectors given 

below. 

Connector Function 

AND Connects a given specification line 

(n) and the following line (n+1) with 
a logical AND operation. Both n 
and n+1 must be "true" to satisfy 
the retrieval criteria. 

OR Connects line (n) and line (n+1) with a 

logical inclusive OR. That is, the 
criteria are satisfied if either speci- 
fication is true, or if both are true. 

EXP Identifies an arithmetic expression 

specification. 

END Identifies the last retrieval specifi- 

cation card in a request. 



Note that the field from columns 23 to 73 is known as the 
operand field. 

RETRIEVED OUTPUT CARD 

The retrieved output specification card (type D) is shown in 
Figure 1 1 . 

Columns Description 

1 -4 Request number: must be the same four-character 

identification that appeared in the general re- 
quest specification card (type A) above. 

6 D^ identifier for the retrieved output specifica- 

tion card. 

8-9 Line number: a code of 01 to 99 that controls the 

format of the Manage output. Both the retrieved 
records and the listed report will maintain data 
fields in the sequence determined by the line 
number. A field that is entered on line 01 will 
be the leftmost field on the report, and so on. 

11-18 Field name, numeric literal, or expression line 

numbers: if the parameter is a fieldname, Retrieve 
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Figure 11. Manage Retrieved Output Specifications 



Retrieved Output Card 29 



Columns Description 



Columns Description 



11-18 will extract the appropriate value and place it 

(cont.) in the output record. It will be listed by Report 
unless specifically suppressed. Any following 
arithmetic expressions may reference the output 
field by its line number. 

A numeric literal consists of an algebraic sign 
followed by up to seven digits, or by up to six 
digits and an embedded decimal point. A nu- 
meric literal does not create an output field and 
will not be listed, but any following arithmetic 
expressions may use it at list time by referencing 
its line number. 

An arithmetic expression consists of a two-digit 
line number, an arithmetic operator (+, -, *,/), 
and a second line number, with no embedded 
blanks. The two line numbers must reference a 
previously-defined output field or numeric literal. 

20 Nonprint indicator: an N suppresses the printing 

of the output field or arithmetic expression de- 
fined on this line. 

22 Sort level: a number from 1 to 9, or blank. If 

nonblank, it identifies this field as a report se- 
quence field and specifies the level of sort. The 
highest level is 1 and the lowest is 9. If the des- 
ignated report sequence fields match the data 
base keys, or if no sort level is found, the re- 
port is to be listed in the original file sequence 
and the Sort program will be bypassed. Note 
that the designation of sort fields is independent 
of the designation of control break fields. 

24 Descending sort indicator: a D means that the 

report requence field should be sorted in descend- 
ing order. 

26 Total break control: a number from 1 to 9, or 

blank. The named field is to initiate the desig- 
nated level of totals whenever itchanges in value. 
The highest-level total break control value is 1. 
For example, a 3 means that the field is to be 
used as the control field for 3rd level totals or 
group counts. When the information in the field 
changes, 3rd level totals or group counts will be 
printed out for all total fields indicated as sum- 
ming level 3 (see below), and also on all lower- 
level total fields. (Higher-level control breaks 
always force lower totals to be printed.) The 
specified level of total break control may be as- 
signed to only one field in the output specification. 
The value field must be a data base field or a re- 
trieval arithmetic result field. If no total breaks 
are specified, thereportwill be a simple listwith 
final totals only. The total byte length of all 
fields used for total breaks may not exceed 255 
bytes. 

Note that the designation of break control fields 
is independent of the designation of sort fields. 
Regardless of any sorting, a change in value of 
a break control field from one retrieved record to 



26 
(cont.) 



28 



29 



30 



31 



32 



33 



another causes the appropriate level (and all lower 
levels) to become "active". All sums, itemcounts, 
minimums, maximums, and averages tied to each 
active level are then printed. 

Summing level: a number from 1 to 9, F, or blank. 
The named field or expression result is totaled and 
associated with nth level total breaks (F = Final 
Total). Up to 15 summed fieldsmay be displayed. 
For example, when a 4th level total break is taken, 
a total will be printed out for the field named, if 
summing level 4 is indicated in column 28. Sev- 
eral fields can be designated as summing level 4; 
totals for all of them will print out when a 4th 
level break is taken. Multiple fields to be totaled 
may be associated with different break levels. 
For example, fields 9, 10, and 13 could be asso- 
ciated with 2nd level breaks, while fields 8 and 
12 could be associated with 3rd level breaks. 
Fields 9, 10, and 13 would be indicated as sum- 
ming level 2, and fields 8 and 12 as summing 
level 3. (The 2nd level break would also force 
the totals on fields 8 and 12; higher levels force 
lower level totals.) However, 9, 10, andl3would 
be printed only on level 2 or higher. 

Item count: an I indicates that the field speci- 
fied by field name is one forwhich the user wants 
an item count. If an I is present, there must be 
an entry in column 26. When a total break is 
taken, a count of the number of items in the 
group will be printed. A blank in the column 
indicates that no group count is to be taken. Re- 
gardless of group count or any other control fea- 
ture, an overall item count is produced automat- 
ically as a final total on every report. 

Minimum value: a number from 1 to 9, F, or 
blank. The minimum value in the named field 
or expression result is retained and printed with 
the specified level of total break. Up to nine 
minimum values may be displayed. 

Maximum value: a number from 1 to 9, F, or 
blank. The maximum value in the named field 
or expression result is retained and printed with 
the specified level of total break. Up to nine 
maximum values may be displayed. 

Average value: a number from 1 to 9, F, or 
blank. The average value of the named field or 
expression result is calculated and printed with 
the specified level of total break. Up to nine 
average values may be displayed. 

New page eject: an E, in conjunction with a 
total break control entry in column 26, causes 
the printer page to advance when a control break 



yCnange in vcius^ occur 



The 






after printing of the totals or group counts. If 
column 33 is left blank, page ejection is con- 
trolled by line count in the Report program. 



30 



Retrieved Output Card 



Columns Description 



Columns Description 



34 Page number reset: an R, in conjunction with a 

new page eject specification (column 33 above), 
causes page numbering to restart at 1 . 

36-37 Number of blanks to right: a number from 00 to 

99. The specified number of print positions (to a 
maximum of one complete print line) will be 
skipped before the next print item is displayed. 
If blank, one space will occur before the next 
item is displayed. 

41-62 Column heading: up to 22 EBCDIC characters to 

be used as a column heading for this report (over- 
rides the standard dictionary heading). The char- 
acter > (greater than) will indicate a new head- 
ing line. 

63-76 Print format picture: controls the preparation of 

data for printing. This specification is required 
for all arithmetic expression results that are listed. 
It is optional for fields named in the dictionary 
and, if specified, overrides dictionary formatting 
control. The picture consists of a series of code 
characters that specify the following information: 

1. The number and kind of characters that will 
appear in the print area assigned to this item. 

2. Decimal scaling, zero suppression, comma 
insertion, negative sign insertion, and dol- 
lar sign insertion. 

Code characters that are used in a picture depend 
upon the nature of the data field being formatted 
as outlined below. 

Alphabetic fields 

1 . An A specifies that the corresponding print 
position is to be occupied by a character 
from the data field. 

2. Any other specified character is to be in- 
serted in the corresponding print position. 
For example, assume a data field JUN0168, 
and a picture of AAAbAAbAA. The display 
would be JUN 01 68. 

Numeric fields (packed decimal and binary) 
1 . Z specifies zero suppression. 

9 specifies that the corresponding print po- 
sition is to be occupied by a number from 
the data field. 

B specifies blank insertion. 

specifies zero insertion. 

. specifies decimal point insertion and ter- 
mination of zero suppression. 

, specifies comma insertion. 



- specifies trailing minus if negative sum. 

$ specifies dollar sign insertion to the left 
of the high order position of the field. 

2. The rules of print editing via picture control 
are the same as those used in SDS COBOL 
(other than dollar sign insertion). 

SAMPLE DATA RETRIEVAL AND REPORT 

The personnel director of Amalgamated Corporation must 
supply the State Department of Employment with a listing 
of all noncitizen female employees. The report is to be 
ordered by name, with the most recent employee listed first. 
The report must show name, address, marital status, social 
security number, and starting pay rate. An averate of the 
starting pay rate for each year must also be calculated. 
Figure 12 shows the required general specifications, while 
Figures 13 and 14 show retrieval criteria and report specifi- 
cations, respectively. The resultant report is shown in Ap- 
pendix D, Figure 15. 

RETRIEVE MESSAGES 

The following messages are output during Retrieve. A print- 
out of the incorrect record precedes the message. 



ABNORMAL OPEN ERROR 



The request pile could not be opened. The run is aborted. 



ARITHMETIC OPERATOR USED WITH ALPHA FIELD 



No arithmetic is permitted on alphabetic (EBCDIC) fields. 
The card image is printed and the remainder of the card 
ignored. The request will not be executed. 



CARD TYPE ERROR 



The specification card type is not A, B, C, or D. The card 
image will be printed with the message and the request will 
be rejected after validation. 



DATA BASE RECORD TOO LARGE FOR AVAILABLE 
MEMORY 



The dynamic memory allocation algorithm was not able to 
assign sufficient space to the data base record input buffer 
to hold one full data base record. A minimum of 1024 words 
will be assigned to the input buffer under the least dynamic 
memory availability. The run will be aborted. 



DESCENDING SORT LEVEL MISSING 



The retrieved output specifications call for a report to be 
sorted in descending order on a field without specifying the 
sort level of that field. The request will be rejected after 
validation. 
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(CIRCLE DESIRED OPTIONS) 



SIGMA MANAGE GENERAL REQUEST SPECIFICATIONS 

Retrieval System 






REQUE5T NO. 


REQUEST SPECIFICATION LIBRARY CONTROL 




ENTER NAME OF: 


SEARCH MODE 


OUTPUT DISPOSITION 


USER RETRIEVAL FORMAT 
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JA 


USE MANAGE LIBRARY 
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ADD REQUEST 
SPECIFICATION TO 
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PRIMARY FILE TO BE 
SEARCHED 
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BY-PASS SEARCH 


B 


USER PROGRAM 


u 


SELECTED FIELDS: /7 
PACKED MULTIPLES (\ 


REQUEST SPECIFICATION 
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Reporting System 
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Figure 12. Sample General Request Specifications 
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Figure 14. Sample Report Specifications 



DICTIONARY READ FAILURE 



The dictionary for the request file is unreadable, 
is aborted. 



The 



DUPLICATE LINE NUMBERS 



The retrieved output specification line numbers are not 
unique. The card image on which the duplicate line num- 
bers was detected will be printed and the request will be 
rejected after validation. 



DUPLICATE SORT OR CONTROL BREAK LEVEL 



The sort or control break level is duplicated on another re- 
port specification. 



EXIT TABLE/DOUBLEWORD OVERFLOW. CUT OFF 
AT xxxx 



The combined exit table (EXITAB) and doubleword table 
(DBLWD) space requirements exceed the memory allocation 
for these two tables. Code generation will be terminated 
and all requests prior to the one that caused the overflow 
will be executed. 



EXPRESSION CONTAINS 2 LITERALS 



Both line numbers in the arithmetic expression refer to lit- 
erals. The expression is rejected. 



EXPRESSION TERM NOT NUMERIC FIELD OR LITERAL 



An expression line number refers to a retrieved output spec- 
ification line that does not specify either a numeric data 
base field, a numeric arithmetic result field, or a numeric 
literal. The request will be rejected after validation. 



EXTRANEOUS DATA IN EXPRESSION FIELD 



An expression in a retrieved output specification may 
contain only two digits (0-9), an arithmetic operator 
(+, -, *, /), and two more digits. This message is printed 
along with the card image if the remainder of the field (col 
umns 16 to 18) is not blank. The request will be rejected 
after validation. 



FIELD NAMED NOT DICT NAME OR ARITH RESULT 
FIELD 



One of the fields on the card was not listed in file DICT 
as a component field of the request file; nor has it been 
previously listed by the requestor as a label to be applied 
to the result of the evaluation of an arithmetic expression. 
The request will be refected after the remaining specifica- 
tions are processed. 



FILE SPECIFIED NOT BATCHED REQUEST FILE 



A request requires a primary or secondary data base file 
other than the file or files specified by the first request in 
the batch. It should be noted that the first request is not 
necessarily the one that is at the front of the input deck but 
rather the request that is sequenced first by the Sort program. 
The general request specification card is printed and the re- 
quest is rejected with no further processing. 
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ILLEGAL SORT OR CONTROL BREAK KEY 



The report specification calls for a sort or control break on 
a literal or arithmetic expression. 



INSUFFICIENT MEMORY AVAILABLE FOR RETRIEVE 



Retrieval will not be attempted without at least 15 pages 
of dynamic memory. This message indicates that 15 pages 
are not available. The run will be aborted. 



INVALID EXPRESSION LINE NUMBER 



One or both line numbers do not exist, or they contain a 
nonnumeric character. 



INVALID FILE DICTIONARY NAME 



No dictionary could be found for the named request file. 
Either the file name was misspelled or the dictionary has 
been lost. The entire run is aborted. 



INVALID DESCENDING SORT SPECIFICATION 



The descending sort parameter is neither D nor blank. 



INVALID DIGIT IN BLANK FILL COUNT 



The blank fill count field on the retrieved output specifi- 
cation card was not blank and it contained a nonnumeric 
character. The rest of the request will be validated but it 
will not be executed. 



INVALID DIGIT IN EXPRESSION LINE NUMBER 



A character other than 0-9 was encountered in an expression 
on a retrieved output specification card. The card image 
will be printed and the remainder of the request will be val- 
idated. The request is rejected. 



INVALID DIGIT IN LINE NUMBER 



At least one of the two digits in the retrieved output speci- 
fication line number field (columns 8,9) is not a numeric 
(0-9). The remainder of the request will be validated but 
the request will not be executed. 



INVALID DIGIT IN LITERAL 



An illegal decimal digit has been detected in a numeric 
literal. The card image is printed and the rest of the card 
is ignored. The request will be rejected after the rest of 
the request cards are processed. 



INVALID DIGIT IN NUMBER OF RECORDS TO OUTPUT 



The maximum number of retrieved output records specified 
by the user on the general request specification form (col- 
umns 51 to 54) contains a nonnumeric character, if it is not 
blank. The remainder of the request will be validated but 
it will not be executed. 



INVALID DIGIT IN NUMBER OF RECORDS TO SKIP 



An illegal character (not 0-9 or all blanks) was found in the 
general request specification card field stipulating the num- 
ber of initial primary file records to be skipped or ignored 
(columns 46 to 49). The remainder of the request will be 
validated, but it will not be executed. 



INVALID ITEM COUNT 



The item count parameter on the above report specification 
line is neither I nor blank. 



INVALID LOGICAL CONNECTOR 



A logical comparison is followed by a connector other than 
AND, OR, or END. The request will be rejected. 



INVALID NON-PRINT SPECIFICATION 



The nonprint parameter is neither N nor blank. 



INVALID NUMERIC LITERAL 



A literal in the above report specification is incorrect. 
Probable causes are: 

1. An embedded blank or all blanks. 

2. Multiple decimal points. 

3. A nonnumeric character. 



INVALID OPERATOR 



The operator on a retrieval specification card is not one of 
the following: EQ, NE, GR, LS, GE, LE, +, -, *, /. 
The card image is printed and the rest of the card ignored. 
The request will be rejected. 



INVALID PAGE COUNT SPECIFICATION 



The page count parameter is neither R nor blank. 



INVALID PAGE EJECT SPECIFICATION 



The page eject parameter is neither E nor blank. 



INVALID SIGN IN NUMERIC LITERAL 



A numerical literal on a retrieval specification card has a 
sign character other than + or -. The request will be re- 
jected after validation. 
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INVALID SORT OR CONTROL BREAK LEVEL 



The sort or control break level parameter is neither 1 to 9 
nor blank. 



INVALID SPEC IN COL. xx 



The general request specification is in error in the column 
specified. The request will be rejected after validation. 



INVALID SUM-MIN-MAX-AVG LEVEL 



One or more of the above parameters is not a number from 
1 to 9 or F. 



I/O ERROR xx TRYING TO READ OR WRITE REQUEST 



The Monitor has returned an error type xx upon being asked 
to read request xxxx from the request library, or to write the 
request into the library. If the error occurred in trying to 
read the request from the library, the request cannot be 
processed. If the error occurred in attempting to write the 
request into the library, the request will be processed but 
it cannot subsequently be called from the library. 



I/O ERROR xx TRYING TO WRITE RPT SPECS 



The Monitor was unable to write a record into the report 
specification file (RPTSPC) for the reason given (xx). This 
message will be followed by a JOB ABORTED message, and 
the run will be terminated. 



ITEM COUNTING RESTRICTED TO CONTROL BREAK 
FIELDS ONLY 



An item count was specified for a field that is not a control 
break key. 



LIBRARY REQ ID xxxx REJECTED. 
OBSOLETE 



DICTIONARY 



The request file DICT and, presumably, the request file it- 
self have been changed since the request was put into the 
library. It is necessary to resubmit the request deck after 
making any changes necessary to accommodate the current 
file structure. 



LITERAL SIZE INCONSISTENCY 



This message indicates that all literal constants in a multiple 
literal string do not contain the same number of characters, 
that a binary constant contains more than 10 digits, or that 
a packed decimal constant contains more than 15 digits. 
The card image is printed and the remainder of the card is 
ignored. The request will not be executed. 



LITERAL SPECIFIED AS LEFT TERM 



A literal or numeric constant is not allowed as the first or 
left term of a criterion or arithmetic expression on a re- 
trieval specification (type C) card. The card image will 
be printed out and the request rejected. The rest of the card 
will not be examined. 



LITERALS EXTEND BEYOND COL.73 



The literal is too large. Retrieve will continue validating 
the remaining request specifications, but the request will 
not be executed. 



MISSING CONTROL BREAK LEVEL 


.evels must be ascending, from 1, with no gaps. 


MISSING CONTROL BREAK REQUIRED FOR AVG 
FUNCTION 




MISSING CONTROL BREAK REQUIRED FOR MAX 
FUNCTION 




MISSING CONTROL BREAK REQUIRED FOR MIN 
FUNCTION 




MISSING CONTROL BREAK REQUIRED FOR SUM 
FUNCTION 



The designated function was specified to appear at a given 
control break level, but no control break key has been as- 
signed at that level. 



MISSING GENERAL REQUEST SPECIFICATION 



The general request specification card (type A) was omitted 
for this request. The remainder of the specifications for 
this request will be skipped. 



MISSING SORT LEVEL 



Levels must be ascending, from 1, with no gaps. 



MORE THAN 9 AVG VALUES SPECIFIED 



The indicated report limitation has been exceeded. 



MORE THAN 20 CONSECUTIVE AND'ED CRITERIA 



Retrieve allows 20 successive AND criteria without an 
intervening OR. If this limit is exceeded, the remaining 
specifications will be validated, but the request will not 
be executed. 
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MORE THAN 9 MAX VALUES SPECIFIED 



The indicated report limitation has been exceeded. 



MORE THAN 9 MIN VALUES SPECIFIED 



The indicated report limitation has been exceeded. 



MORE THAN ONE DECIMAL POINT IN DECIMAL 
LITERAL 



The remainder of the request will be validated, but it will 
not be executed. 



MORE THAN ONE GENERAL REQUEST SPEC FOR 
REQUEST 



Only one type A card is allowed per request. The second 
card will be printed and skipped and the remainder of the 
request will be rejected after validation. 



MORE THAN ONE HEADER SPECIFICATION 



Only one page header card (type B, number 01) is allowed 
for each report. If more than one header card is submitted, 
the request specifications will be validated, but the request 
will not be executed. 



MORE THAN 15 VERTICAL SUMS SPECIFIED 



The indicated report limitation has been exceeded. 



NO VALID REQUESTS IN THIS RUN 



Every request in the batch contains discrepancies. The job 
is terminated. 



NUMERIC LITERAL SCALING ERROR 



Multiple packed decimal literals do not all have the deci- 
mal point in the same position. The request will be rejected 
after validation. 



OUTPUT SPECS SPECIFIED WITH ENTIRE RECORD 
OPTION 



Retrieved output specifications were included in a request 
for which "entire record" was specified on the general 
request specifications. The entire record will be retrieved. 



PRIMARY AND SECONDARY FILE KEYS INCOMPATIBLE 
RUN ABORTED 



This message indicates one of three possible conditions: 

1. The files to be matched have no common key field. 

2. The mode of a key field (EBCDIC, binary, or packed 
decimal) is not the same in the two files to be matched. 

3. The two files are not sorted in the same direction on a 
common key field. That is, one file is sorted in ascend- 
ing order and the other in descending order. 

If any one of these conditions obtains, the files cannot be 
matched. The run will be aborted. 



MULTIPLE LITERALS IN ARITHMETIC EXPRESSION 



An arithmetic operation was specified between a previously- 
defined field and a list of compound numeric constants. The 
second term in an expression may contain only one numeric 
literal. The request will be rejected. 



NO RETRIEVAL SPECIFICATION END CARD 



No retrieval specification card with END in columns 75 to 77 
was found in a request. The retrieved output specifications, 
if any, will be validated but the request will not be 
executed. 



REQUEST ID xxxx ABORTED. ARITHMETIC TRAP 



When an arithmetic trap is encountered during the execution 
of any request, this message will be output and the request 
will be terminated. Any previously-retrieved data, and 
possibly the current record, will be saved and processed 
normally either by Report or as a partial user file. 



REQUEST ID xxxx AND ALL FOLLOWING NOT DONE. 
EXECUTION PROGRAM OVERFLOW 



Memory allocation for the execution program is not adequate 
to generate the code necessary to execute all the requests. 
The requests that do fit are executed. 



NO VALID GENERAL REQUEST SPEC IN BATCH 



Retrieve wiii not begin processing specifications untii the 
first general request specification card (type A) is read. 
This message indicates that there are no general request 
specifications cards in the request input. The run is aborted. 



REQUEST ID xxxx REJECTED. MULTIPLE ENTRY ARITH 
OFLOW 



The 51 1 -word multiple-entry arithmetic-table (MEATBL) 
capacity has been exceeded. The request will be rejected 
without further processing. 
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REQUEST ID xxxx REJECTED. NO REPORT SPECS. 



The general request specification card identified the output 
for this request as a report. No report specifications (re- 
trieved output specifications) were submitted with this re- 
quest identification. The request will not be executed. 



and all the affected arithmetic expressions are not of the 
same mode. When the storage location is first assigned, 
it is given the mode of the terms of the arithmetic expres- 
sions. Expressions that use this same result field must agree 
with it in mode. Any disagreement will cause the request 
to be rejected after any remaining specifications are 
validated. 



REQUEST ID xxxx REJECTED - NO SEARCH OR 
RETRIEVE SPECIFICATIONS 



Search or retrieve specifications were omitted. 



REQUEST ID xxxx REJECTED. 
REQUEST 



PREVIOUS USER FILE 



Only one request for a nonreport file is permitted in a 
batch of requests. The first one encountered will be 
accepted. Any others will be rejected. 



REQUEST ID xxxx REJECTED - SPECIFICATION ERROR(S) 



This message is printed at the end of an incorrect request. 
It is preceded by one or more error messages describing the 
specific errors that caused the rejection. 



REQUEST SPEC READ FAILURE 



The input/output handler for the specification cards has 
returned an abnormal or error condition. The rest of the 
request cards are skipped. 



REQUEST SPECIFICATIONS FOR xxxx OVERFLOW 
AVAILABLE MEMORY. REQUEST REJECTED. 



Request xxxx overflowed the available space for the Retrieve 
working table. This request will be rejected and an attempt 
will be made to fit the next request into the available space. 
After all the requests that fit are processed, the file retrieval 
will be initiated. All the requests listed in this message 
must be rerun. 



RESULT FIELD NAME SAME AS DATA BASE FIELD NAME 



The name assigned to the storage location of the results of 
evaluating an arithmetic expression (as specified by the 
user in columns 66 to 73 of the retrieval specifications) is 
the same as the name of a field in the request data base file. 
The request will be rejected after validating remaining 
specifications. 



RIGHT AND LEFT TERM MODES DO NOT AGREE 



Mixed-mode comparison or mixed-mode arithmetic is not 
permitted. Both terms in a comparison must be either EBCDIC, 
packed decimal, or binary. If the right-hand term is either 
a single or multiple literal constant, the literal format must 
be appropriate to the left term. That is, if the left term 
is EBCDIC, each literal constant must begin with an equal 
sign and end with a comma. If the left term is binary, each 
literal constant must begin with a plus or minus sign, and 
may have no embedded blanks or decimal points. If the left 
term is packed decimal, each literal constant must be pre- 
ceded by a plus or minus sign and must contain one decimal 
point and no embedded blanks. The card image will be 
printed, the rest of the card ignored, and the request rejected. 



SPECIFICATIONS FOR LIBRARY REQUEST 



Retrieval and/or retrieved output specifications were sub- 
mitted for a library request. The specifications will be val 
idated, but the request will not be executed. 



REQUEST SPECS UNEXPECTEDLY TERMINATED 



The end of the batched input was encountered while pro- 
cessing retrieval specifications, but before the END card 
was found. This request will not be executed. 



SPECS FOLLOW 'END' CARD OR BYPASS SEARCH 
OPTION 



Retrieval specifications were included in a request in which 
"bypass search" was specified. The specifications are 
ignored. 



RESULT FIELD MODE INCONSISTENT WITH MODE OF 
TERMS 



The user has assigned the same storage location to the 
result of more than one arithmetic expression evaluation, 



SUM-MIN-MAX-AVG OF LITERAL OR ALPHA FIELD 



None of the above functions may be specified for a literal 
or alphabetic field. 
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TOO MANY DIGITS IN NUMERIC LITERAL 



A packed decimal literal contains more than 15 digits or a 
binary literal has more than 10 digits. The request will be 
rejected after validation. 



TOO MANY RESULT FIELDS IN xxxx. 
REJECTED. 



REQUEST 



An entry is added to file DICT for each arithmetic expres- 
sion result in a given request. These additional entries are 
cleared out between requests. If the additional entries 



overflow the 2048 words allotted to DICT, the request will 
be aborted. 



TOTAL SIZE OF BREAK FIELDS EXCEEDS 255 CHAR 



The field above is specified as a sort or break control key. 
Its length, plus the length of all fields previously designated 
as keys, is greater than the allowed maximum of 255 charac- 
ters. The request will be rejected. 



UNREADABLE INPUT RECORD 



A request file record could not be read. The run is aborted. 
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5. REPORT 



The Report program prepares printed Reports from data ex- 
tracted by the Retrieve program. Report performs the fol- 
lowing functions: 

• Reads the Report specification file for descriptions of 
requests to be listed. 

• Reads the Report specification file for format specifi- 
cations of the records applicable to requests. 

• Sets up the required call for Sort if the report is in a 
sequence different from that of the original data base. 
Sets up sorting specifications, input/output file char- 
acteristics, and identifiers of the records to be selec- 
tively sorted. Links to the Sort. 

• Builds a set of tables to control the formatting of the 
desired report. 

• Reads the input file (from either Retrieve or Sort) and 
prepares the required report. 

• Determines if all requests have been processed. If yes, 
ends the job. If any reports remain, returns to the first 
step in the processing cycle. 

The Report program makes use of the following inputs: 

1. Retrieved output data files, consisting of: 

a. Report specifications (by request number), and re- 
trieved record format specification (by request 
number). 

b. Retrieved data records (variable formats, by re- 
quest number). 

2. Column headings and editing information from the 
dictionary. 



REPORT SPECIFICATIONS 

Specifications governing the format of the desired report 
for any given request are passed to Report in a separate 
file on the RAD. These specifications are of three general 
types: 

1. Report format table: a single variable-length record 
packed with all the general and line descriptions sub- 
miffed by the user. This information is used to set up 
the columnar arrangement of the listing, arithmetic 
operations, sequencing, and totaling. 

2. Report text string: a single variable-length record con- 
taining the report heading text and page heading text. 

3. Extracted data format table: a single variable-length 
record which defines the format of the data records 
extracted for this request. 



REPORT CONVENTIONS 

The following constraints and conventions apply to the 
Report program. 



HORIZONTAL TOTALING 



Horizontal totaling is accomplished by using the arithmetic 
expression capability. After two fields are initially de- 
fined, their line numbers are specified in an additive ex- 
pression. If more than two fields are to be totaled, the 
intermediate expression results may be print-suppressed 
and rolled through as many horizontal additions as re- 
quired. For example, the specifications below result in 
the printing of fields 1, 2, and 3, and the horizontal sum 
of all three (see line 05). 



Field Name, Arithmetic 
Line Result Name, Numeric Literal, 
No. or Expression Line Number 



Non 
Print 



Print 

Format 

Picture 



01 
02 
03 
04 
05 



Field 1 
Field 2 
Field 3 
01 +02 
03 + 04 



N 



$9,999.99- 



Note that the horizontal sum may be vertically totaled, 
averaged, or analyzed for minimum/maximum values. 



TEXT FIELDS 

Output fields defined as text fields (data type T) are 
assumed to be alphabetic. They may not be used in arith- 
metic expressions, and may not exceed 255 characters in 
length if used as a report key. The following procedures 
apply when printing a text field. 

1. Report skips to a new line. 

The text is indented one inch from left and right margins. 



Automatic line folding occurs (without hyphenation) 
if the field exceeds one line. 

Trailing blank lines are suppressed. 

The field name is listed to the left of the first line. 

No column headings are used. 

ALPHABETIC FIELDS 



Alphabetic fields whose total length cannot be printed on the 
line being constructed will cause a line feed. Up to one full 
line will then be printed, with no blank suppression. If the 
field length still exceeds one line, it will be truncated. 



Report 39 



BINARY FIELDS AND EXPRESSIONS 



The print width of a binary value is equal to one-third the 
number of bits, plus one additional character. The maxi- 
mum value that can be converted and printed is 2^'- 1. 
Print punctuation for data fields is obtained from fileDICT. 
A print picture may be specified for arithmetic expressions, 
or to override field specifications in file DICT. 



FRACTIONAL SIGNIFICANCE 



Retention of fractional significance (number of decimal 
places) in arithmetic-expression results is as follows: 

1. Addition and subtraction: the result is carried to the 
greatest number of places in either term. 

2. Multiplication: the result is rounded to the greatest 
number of decimal places. 

3. Division: the result is truncated to the greatest num- 
ber of places in either term. 

CALLING REPORT 

The Report program uses the Batch Processing Monitor for 
file services and overlay loading. Report makes use of 
output files, created by Retrieve, that contain report/data 
definitions and extracted data records. If the user elects 
to use standard headings and printing formats (via 'the de- 
fault print layout), Report accesses them from file DICT, 
which was created by the dictionary generator. Sort is 
used when the listing sequence differs from the original 
data base sequence. 

Input for a Report run consists of the Report processor call 
card explained below. The description of the retrieved 
output card is given in Chapter 4. 

The Report processor call card is of the form 
! REPORT 



where ! REPORT is required as shown starting in column 1. 

After being called, the Report program opens the specifi- 
cation file and reads those specifications pertaining to the 
first request. The report sequence is compared against the 
original data base sequence. If they are the same, sorting 
is not required, and the actual list phase will be entered 
directly. If the sequence of the retrieved data must be 
changed, Sort will be called. The Sort program will read 
in the entire retrieved data file, select the records per- 
taining to the request being processed, sequence them as 
required, and then enter the iisting phase. If errors are 
found in a request, it will be aborted and the next listing 
will be attempted. At the end of each list, the 



specification file will be examined for remaining re- 
quests, and the cycle will be repeated as needed. 



REPORT MESSAGES 



The following messages are output during Report. 



CANNOT FIND REPORT INPUT FILE 



The Report program was unable to open the report input 
file. The file may not exist. 



CANNOT READ REPORT SPECIFICATION FILE 



An error or abnormal condition has occurred while reading 
the Report specification file. The file may not exist. 



END MANAGE REPORTS-RESTORE STANDARD 
PRINT FORM 



All user-specified special reports have been printed. 



HEADINGS FOR MORE THAN 2 DETAIL 
LINES ARE OMITTED 



Not enough headings are present for the total number of de- 
tail lines. This message is shown on the first page of the 
affected report listing. Each retrieved record will be com- 
pletely listed with headings for the first two lines only. 



MANAGE: LOAD x PART FORM-xxx 
WIDE -xx LINES/PAGE 



Operator intervention is required to set up the specified 
type of paper. (Message appears at operator's console.) 



MANAGE: LOAD SPECIAL FORM FOR REQUEST xxxx 



Operator intervention is required to set up the special form. 
(Message appears at operator's console.) 



MANAGE REQUEST xxxx FORM SPECIFICATIONS 
REQUIRED - ENTER 2 DIGIT NUMBER OF LINES 



The two-digit line-number parameter is required. (Message 
appears at operator's console.) 



MANAGE REQUEST xxxx FORM SPECIFICATIONS 
REQUIRED - ENTER 3 DIGIT NUMBER OF PRINT 
POSITIONS 



A three-digit print-position-number parameter is required. 
(Message appears at operator's console.) 



MEMORY OVERFLOW 



Either there is insufficient memory to read in the report 
specification file from Retrieve, or there is no common 
page for Sort communication. 
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MISSING FIELD NAME IN FORMAT RCD 



A field name has nof been transferred properly from 
Retrieve to Report. 



MISSING REPORT CONTROL ENTRY-REQ xxxx 



A report specification record key has nof been transferred 
properly from Retrieve to Report. 



MISSING REPORT FORMAT RCD - REQ xxxx 



A report format record has not been transferred properly 
from the Retrieve program to Report. 



NUMBER OF PRINT LINES PER RCD OVER 255 



The request is aborted because the number of print lines 
exceeds the allowed maximum. 



READ ERR ON STANDARD HEADING DICTIONARY 



The Report program was unable to read successfully the 
dictionary record containing the standard column headings. 



REQ TERMINATED - ARITH TRAP PROCESSING 
PRINT ENTRY xx 



An illegal arithmetic procedure was defected in the indi- 
cated line. The request is aborted and the next request is 
attempted. 



UNABLE TO COMPLETE REPORT - INADEQUATE 
MEMORY 



Available memory space is insufficient for complete pro- 
cessing of the report. 



UNREADABLE RCD ENCOUNTERED-REQUEST ABORTED 



An unreadable data record has been found in the Report 
input file. The next request in the batch will be attempted. 
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APPENDIX A. SAMPLE MANAGE DECK SETDPS 



Manage operating examples are given below. The first- four 
describe deck structures required to enter the four Manage 
processors into the System Library. The remaining five ex- 
amples describe required deck setups for using the pro- 
cessors. Note that these illustrations do not show any limit 
cards since they are installation-dependent. The deck set- 
ups will also vary for different combinations of RAD, tape, 
and device assignments. Appendix B contains DCB informa- 
tion necessary when complex input/output assignments are 
required. 

During execution, the Manage processors send various mes- 
sages to the operator's console, such as tape mount and 
dismount commands. Required responses are described in 
the Batch Processing Monitor manual. The only nonstan- 
dard operator responses that may be required occur in the 
Report process, as outlined below. 

1 . Reports are grouped by paper type and number of 
copies. At the start of each group, the operator is 
informed of the form required in the printer, and 
printing is suspended until the operator keys in the 
appropriate BPM continue command. 

2. Each report requiring a special form causes a suspen- 
sion of processing until the operator keys in the num- 
ber of print positions and line depth pertaining to that 
form. The console key-in procedure is prompted by 
Report after identification of the request being 
processed. 

The standard Dictnary processor is constructed from the 
three temporary element files produced by the deck shown 
in Example A-l . 

The deck in Example A-2 produces three element files from 
which are constructed either the standard Fileup processor, 
or the Fileup processor with user own-code. This module 
is callable with an OWNUP card. 

The standard Retrieve processor is constructed from the four 
temporary element files produced by the deck shown in 
Example A-3. 

The standard Report processor is produced by the deck 
shown in Example A-4. 

The deck in Example A-5 illustrates a run that either up- 
dates a previous dictionary or creates a new one. The re- 
sulting file will contain all dictionaries defined under the 
current account number. 

The deck in Example A-6 illustrates the updating of an 
existing RAD file. The Fileup specifications and the 
change transactions are on cards. The sorted transaction file 
UPTRAN is deleted at the end of the update process. 

The deck in Example A-7 illustrates the updating of an 
existing tape file. The Fileup specifications are taken 



from a library named SPEC, and the change transactions 
are to be read from tape. The transactions are to be sorted 
and placed on another tape before the update begins. An 
audit file is also to be created on tape. 

The deck in Example A-8 illustrates a retrieval and report 
generation run containing one or more requests. The data 
base is a RAD file, and all intermediate outputs are also 
defaulted to the RAD. 

The deck in Example A-9 illustrates a retrieval run in 
which all requests require a match between a primary tape 
file and a secondary RAD file. A user file is to be created 
on tape, and requests to be listed are on another tape. 
During the Report process, any required sorting is to be 
done using 9-track tapes. 

Example A-l. Forming the Dictnary Processor 



!FIN 



STREE DICTN-(DICTN1,DICTN2) 



(LMN, DICTNARY), (TSS, 50) 



i 



1(DICTN2)), (MAP), (PERM),; 



■-^1 



! OVERLAY (EF,(DICTN),(DICTN 1 ), ; 



DICTN2 PROGRAM 



^ 



IFMGE (ENTER) 



J 



[ASSIGN M:EO,(FILE,DICTN2) 



DICTN1 PROGRAM 



IFMGE (ENTER) 



! ASSIGN M:EO,(FILE,DICTNl) 



M 



DICTN PROGRAM 



=Q 



IFMGE (ENTER) 



'.ASSIGN M:EO, (FILE, DICTN) 



!JOB :SYS,ANYNAME,F 
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Example A -2. Forming the Fileup Processor 



M 



!FIN 



1TREE FILEUP0-(FILEUP1,FILEUP2) 



!EOD 



User Own-Code Program (s) 




OWNUP),(PERM),(MAP),(TSS,50) 



i (FILEUP1),(FILEUP2)),(LMN, ; 



! OVERLAY (BI),(EF,(FILEUPO), ; 



!TREE FILEUP0-(FILEUP1,FILEUP2) 



(MAP),(TSS,50) 



(FILEUP2)),(LMN,FILEUP),(PERM), ; 



! OVERLAY (EF,(FILEUP0),(FILEUP1) 



J 



Q 



J 



FILEUP2 Program 



1FMGE (ENTER # PERM) 



1ASSIGN M:E0 / (FILE f FILEUP2) 



J 



FILEUP1 Program 



1FMGE (ENTER,PERM) 



'ASSIGN M:E0,(FILE,FILEUP1) 



FILEUPO Program 




1FMGE (ENTER,PERM) 



! ASSIGN M:EO,(FILE,FILEUPO) 



!JOB :SYS,ANYNAME,F 





J 
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Example A-3. Forming the Retrieve Processor 



M 



!FIN 



!GENTR,RTRV1) 



STREE RETRO-(VALID,INTPTR, ; 



! (PERM),(LMN / RETRIEVE) / (TSS / 50) 



KINTPTRMGENTR^RTRVIJMMAP), 



! OVERLAY (EF, (RETRO), (VALID),; 



M 



SRTRV1 Program 




!FMGE (ENTER) 



SASSIGN M:EO(FILE / RTRVl) 



SGENTR Program 




!FMGE (ENTER) 



SASSIGN M:EO,(FILE,GENTR) 



M 



I 



INTPTR Program 



SFMGE (ENTER) 



SASSIGN M:EO,(FILE,INTPTR) 



M 



VALID Program 




SFMGE (ENTER) 



SASSIGN M:EO,(FILE,VALID) 



RETRO Program 




SFMGE (ENTER) 



SASSIGN M:EO,(FILE,RETR0) 



SJOB :SYS,ANYNAME,F 



\ 
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Example A-4. Forming the Report Processor 



Example A-5. Dictnary Creation or Modification 



M 



I FIN 



Report Program 



!(LMN,REPORT),(TSS,50) 



!LOAD (BI), (MAP), (PERM),; 



UOB :SYS,ANYNAME,F 



A 



!FIN 



!EOD 



Unsorted Dictionary Specifications 



<^ 



! DICTNARY 



!JOB ANYNO,ANYNAME,F 



J 



Example A-6. Updating a RAD File 



M 



1FIN 



1FMGE (DELETE) 



1ASSIGN M:EI,(FILE,UPTRAN) 



!EOD 



M 



Change Transactions 



!EOD 



Transaction Specifications 



1FILEUP U 



(ASSIGN F:NEWMST,(FILE,EMPMST) 



[ASSIGN F:OLDMST,(FILE,EMPMST) 



UOB ANYNO,ANYNAME,F 





J 
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Example A-7. Updating a Tape File 



Example A -9. Matched Retrieval and Report Generation 



[FIN 

| ! FILEUP U L SPEC 



[ASSIGN F:UPAUDT,(DEVICE,9T) 



!(LABEL,EMPMST) 



! ASSIGN F:NEWMST, ; 



! (LABEL,EMPMST),(INSN,4) 



iASSIGN F:OLDMST, ; 
-| i(INSN,132),(OUTSN,132),(REL) 



IASSIGN F:UPTRAN,(LABEL,ABC),; 



!(INSN,5) 



IASSIGN F:TRNACT,(DEVICE,9T),; 



UOB ANYNO,ANYNAME,F 



Example A-8. Retrieval and Report Generation 



!FIN 



[REPORT 



Z 



!EOD 



Retrieve and Report Specifications 



! RETRIEVE 



IASSIGN F:MSTRFILE,(FILE,EMPMST) 



UOB ANYNO,ANYNAME,F 



J 



!FIN 



! REPORT 



iASSIGN F:SCRF8,(PEVICE,9T) 
IASSIGN F:SCRF7,(DEVICE,9T) \ 



| IASSIGN F^CRFd^DEVICE^T) 



[ASSIGN F:SCRF5,(DEVICE,9T) 



[ASSIGN F:SCRF4,(DEVICE,9T) 



iASSIGN F:SCRF3,(DEVICE,9T) 
[ASSIGN F:SCRF2,(DEVICE,9T) 



[ASSIGN F:SCRFI,(DEVICE,9T) 



!(INSN,108),(OUTSN,108) 



[ASSIGN F:RPTIN,(LABEL,TEMP), ; 



Zj 



!EOD 



Retrieve and Report Specifications 




[RETRIEVE 



[ASSIGN F:REPORT,(LABEL,RTRVDr 



[ASSIGN F:NONREPT,(DEVICE,9T) 



[ASSIGN F:SECFILE,(FILE,XYZ) 



!(INSN,52) 



[ASSIGN F:MSTRFILE,(LABEL,ABC),;\ 

\ 



[JOB ANYNO,ANYNAME,F 
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APPENDIX B. DCB NAMES FOR MANAGE PROCESSORS 



Table 3 below gives the DCB names used by the Manage 
processors. Note that DCB defaults in Manage are arranged 
so that if all jobs are run under the same account number 
and if RAD space is available to handle the intermediate 
files, ASSIGNs are required for the following DCB names 
only. 

DCB Name Description 

F:OLDMST The input master file in Fileup 

F:NEWMST The output master file in Fileup 

F:UPAUDT The optional audit file in Fileup 

F:MSTRFILE The input data base file in Retrieve 



DCB Name Description 

F:SECFILE The optional secondary input data 

base in Retrieve 

F:NONREPT The optional user output file in 

Retrieve 

In such a situation, all parameter specifications and change 
transactions will be read through the SI device (usually 
cards). 

In addition to the DCBs shown, all processors write error 
messages and diagnostics through the M:LO DCB. All 
DCBs accept account and password information via ASSIGN 
records. 



Table 3. DCB Names for Manage Processors 



DCB Name 


Function 


ASSIGN Required 


Comments 


Dictnary 


M:SI 


Input specification records. 


No 


Defaults to system SI device. 


F:DCTSPC 


Sorted input specification 


No 


Defaults to RAD. If assigned to tape, 




records. 




INSN and OUTSN are required. 


F:DICT 


Central dictionary input/ 
output. 


No 


To RAD only. 


Fileup 


M:SI 


Input specification records. 


No 


Defaults to system SI device. 


FiDICT 


Central dictionary input. 


No 


To RAD only. 


F:TRANS 


Specification library input/ 
output. 


No 


To RAD only. 


F-.UPSPCS 


Sorted input specification 


No 


Defaults to RAD. If assigned to tape, 




records. 




INSN and OUTSN are required. 


F:TRNACT 


Input change transactions. 


No 


Defaults to system SI device. 


F:UPTRAN 


Sorted input change trans- 


No 


Defaults to RAD. If assigned to tape, 




actions (optional). 




INSN and OUTSN are required. To 
release the sorted transaction file, use 
FMGE after a successful run. 


FrOLDMST 


Input master file. 


Yes 


May be to RAD, tape, or device. 


F:NEWMST 


Output master file. 


Yes 


May be to RAD, tape, or device. 


F:UPAUDT 


Output audit file (optional). 


Yes 


May be to RAD, tape, or device. 


Retrieve 


M:SI 


Input specification records. 


No 


Defaults to system SI device. 


F:DICT 


Central dictionary input. 


No 


RAD only. 


F:MSTRFILE 


Input data base. 


Yes 


May be to RAD, tape, or device. 
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Table 3. DCB Names for Manage Processors (cont.) 



DCB Name 


Function 


ASSIGN Required 


Comments 


Retrieve (cont.) 


F:SECF1LE 


Input secondary data base 
(matching option). 


Yes 


May be to RAD, tape, or device. 


FrNONREPT 


Output user file (optional). 


Yes 


May be to RAD, tape, or device. 


F:SI 


Sorted input specification 
records. 


No 


Defaults to RAD. If assigned to tape, 
INSN and OUTSN are required. 


F-.REQLIB 


Retrieve specification library 
input/output. 


No 


To RAD only. 


F-.RPTSPC 


Output report specification 
file. 


No 


To RAD only. 


F:REPORT 


Retrieved data output file. 


No 


Defaults to RAD. May be assigned 
to tape. 


Report 


F:DICT 


Central dictionary input. 


No 


To RAD only. 


F:RPTSPC 


Input report specification file. 


No 


To RAD only. 


F:RTRVD 


Retrieved data input file. 


No 


FrREPORT DCB from Retrieve is carried 
over automatically. 


F:RPTIN 


Sorted report data input file. 


No 


Defaults to RAD. If assigned to tape, 
INSN and OUTSN are required. 
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APPENDIX C. OWN-CODE LINKAGE FOR FILEUP 



Registers 5 to 7 are used for communication between Fileup 
and the, various user modules. In Table 4, below, these 
registers are described at the time of entry into the user's 
code and at the exit back to Fileup. Address values are at 



word resolution unless otherwise specified. An x indicates 
that the value in the designated retister is not significant. 
A method for generating a Fileup processor with user own- 
code is shown in Appendix A. 



Table 4. Register Use for Own-Code Linkage 



Entry Point 


Register 5 


Register 6 


Register 7 


FUPOP 


Entry 


X 


Return address. 


X 


Exit 


X 


X 


X 


FUPHD 


Entry 


means that the input mas- 
ter label has been read. 


Return address. 


Byte address of input label 
buffer." 


Exit 


X 


X 


X 


Entry 


1 means the output master 
label is ready to be written .* 


Return address. 


X 


Exit 


X 


X 


Byte address of user's output 
label buffer." 


FUPIM 


Entry 


Return address to delete 
this input master record. 


Return address to use this 
input master record. 


Byte address of input master 
record. 


Exit 


X 


X 


X 


FUPMT 


Entry 


Byte address of matched 
change transaction 
record. 


Return address. 


Byte address of matched input 
master record. 


Exit 


X 


X 


X 


FUPOM 


Entry 


Return address to delete 
this output master record. 


Return address to write 
this output master record. 


Byte address of output master 
record. 


Exit 


X 


X 


X 


FUPCL 


Entry 


X 


Return address. 


X 


Exit 


X 


X 


X 


The entry to FUPHD for output label processing is made before the entry for input label processing. 

Does not apply to master files with one or more header records ending with a file mark (F in user header label indicator 
of Dictnary file definition card). The user is responsible for reading and writing all such header records and file mark. 
Fileup will enter FUPHD after opening the input or output file. However, all required reading and writing of header 
records and file mark must be done in the user own-code. Fileup will resume processing under the assumption that the 
input or output file is positioned for reading or writing master data records. 



INPUT AND OUTPUT LABEL FORMATS 

The following conventions are observed in the processing of 
input and output label buffers: 

1 . The first byte of the buffer contains the length of the 
label which follows. 



The second byte of the buffer contains the start of the 
label information. 

Since the buffer is assumed to start on a word boundary, 
the label length byte occupies the first byte of a word. 

Label length should not exceed either 255 bytes, or the 
length of a data block, else truncation will occur. 
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APPENDIX D. SAMPLE MANAGE RUNS 



The sample dictionary printout shown below results from the file description given in Chapter 2. 



MAMAQE DATA 


FILE DICTI? 


NARY 










TIME 5 DATE! 0?!l4 JUN 11* '69 PAGE! 


1 


*### 


file; 


MASTER **** LSGICAL RECORD CHARACTER LENGTHS 1?84* BLOCKING FACTBR ! 
M8NIT8R FORMATTED, UNLABLFO 
COMMENTS: AMALGAMATED MANUFACTURING CORP.- MASTER FILE 




LEU 
CHAR 
P8SN 


FIELD 
CHAW 

LENGTH 


FIELD 
NAME 


FIELD 
TYPE 


C8NTR8L 

C8UNTER 

FIELD 


KEY CNTL 
6R0ER 

DIR 


FIELC 
AUDIT 
FLAG 


) DECIMAL 2ER6 PRINT TRAIL 
P6INT SUPP C8MMA DPLLaR MINUS 
POSITION RESS INSERT SIGN SIGN 


LEFT 
CHAR 
P8SN 


t • « * 

3 


• • • 

1 


DIVISI9N 


iilNRY 




• 
i 


* 
A 


♦ # • • • 


• t * * • 

STANDARD RFP8RT C6LUMN HEADINGS 


• t • • 

3 


Z 

OIV 


7 


2 


EMPN5 


9INRY 




2 


A 




EMPL> N8 


.7 


9 


21 


NAME 


ALPHA 










EMPL8YFE NAME 


9 


30 


39 


ADDRESS 


TEXT 












30 


30 


20 


Ll 


ALPHA 










STREET 


30 


50 


19 


L2 


■ALPHA 










CITY-STATE 


Bn 


69 


3 


ZIP 


?ACKD 










ZIP>C8DE 


*9 


79 


9 


SP^EC^e 


ALPHA 










S8CIAL>SECURITY>NUMBER 


79 


88 


6 


bIRTHOTE 


ALP M A 










DATE PF> BIRTH >M8/DY/YR 


S8 


94 


1 


SEX 


ALPHA 










S>F>X 


94 


95 


1 


MARITAL 


ALPHA 










M>R>T>L 


9«S 


101 


1 


CITIZEN 


ALPHA 










C>T>Z>N 


mi 


102 


6 


HIREDATE 


ALPMA 










DATE *F> HIRE >M8/DY/YR 


in? 


102 


2 


HIREMB 


ALPHA 












in? 


106 


2 


HIRFYEAR 


ALPHA 












106 


109 


3 


hl^ERATE 


PACO 










3 7 * ■ 

RATE> AT >HIRE 


109 


132 


1 


DEFEND 


3INRY 










Z 

N8>8F>0EP 


13? 


137 


10 


P8SITI8N 


ALPHA 










J8b>TlTLE 


137 


151 


3 


PAYRATE 


PACKD 










S Z C » • 

RATE> 8F > PAY 


1Ft 


154 


6 


PAYOATE 


* i DU * 

^u^HA 










r\»Ti- ^DiTr (>rTvMO/nV/¥B 


154 



Figure D-l . Sample Dictionary 
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. SDS SIGMA MANAGE 


* 








MANAGf REGUE'ST 


SDLM 








REPORT 

FEMALE 

KEF8RT 

HIRr 

HIRE 


T5 STATE 0E p A=?T"1EN'T *F 

EMPLOYEES. 

IS SEQUENCED BY; 
YEAR (DESCENDING) 
"RNTH (DESCEND I M3) 


E 


"'FLSYMF*' 


T SH9WING 


*LL NBNCITI7EN 






k* A "^ £. 

THL RFPI5* 
IMCLJPI^ 


T SHS'aS vA»ieus itc-ms 

STARTING RATE PF PAY, 
3E STARTING RATF f*F PA 


PF DATA F*>R EACH E 
Y F^R FACH YEAR IS 


■1HL9YEE* 
ALSe SHf)W\'. 




v)UN 11* '69 




N?NCimt ? - 


FE 


*ALF 


c-y 


=>L?YFLS 




1 


DATE 3F 

HIRt 
M9/DY/YK 


FN,p|.3YEF. NA'-iE 




E^IPL S6CIAL 
*9 SECURITY 
NUMBER 


v. 

R 

T 
L 


Nft 

eF 

DEP 




J3B 
TITLE 


RATF 

AT 
MIRE 




10-12-69 
ADDRESS 


14 79 tEVF^LY OR 




01550S 570-39-660? 
Lf^G 3F.ACH CAL* 


K 


2 




v.IRER 


* 1.800 




08-10-69 


QTEiOAK FVS^'E 




026986 ?S0-*7-6«3? 


^■ 


B 




ASSE^3LER 


* 1.850 




08-10-69 
ADDRESS 


DIXtrN >'At.~ILY\ 
*21U TA^T Av'F. 




01397* 560*22-3186 
LY^99D CAL. 


M 


5 




ASSF^SLFR 


* 1.855 




08-10-69 
ADDRESS 

HIREYLAR 


DRISC6LL SARAH 
17C* 1.3M ST 
AVE"«AG? 




02626c 55**6?-538* 
HCEAN PARK CALt 


f 


2 




ASSEMBLER 


* 1.875 
« 1.8*5 




HIWEYfc-AR 


I TE^ C«l>T 00000* 


















10-12-68 
ADDRESS 


HC-LT CARf-L 

31? NpRACi* 4V£ 




P?77«6 536-39-6167 
L9-G BEACH CAL. 


h' 


2 




*!RER 


* 1.755 




10-10-68 
ADDRESS 


H9R\f!A">i Rf> : 3ERTA 
*8ir ML AY AVE 


A 


025339 57^-39-1*3= 
vE v ICE CAL. 


M 


2 




CLERK 


* 1.800 




10-10-68 
ADDRESS 


HE'-;AF*D "iRTHA 
151* VHIT 9T 




027909 575*7?-) *3 r > 
-•ARVISTA CAL« 


y 


* 




CLERK 


* 1.825 




07-17-68 
ADDRESS 


iiALUC? 'RUTH 
376 'L^A ST 




012*72 39*-3?-?812 
MERMflSA 8EACI-! CAL. 


M 


1 




SECRETARY 


* ?.750 




03-03-6R 
ADDRESS 


LESTER SUSA\ 
31?? ARIZONA ST 




01725* 535-19-5**'' 
3CFAN PARK CAL. 


w 


1 




*IRER 


<6 3.100 




03-03-63 

ADDRESS 

HIREYLA^ 


Li)3A\ j3AN 
21?. C6L3RA.0L A./L 
AVFRAQF 




n295*2 522-20-7169 
VENICE CAL. 




1 




*IRER 


* P.110 

* 2.057 




HIREYEAR 


ITFM CSUNf 000006 


















09-07-67 
ADDRESS 


HUTH HSRTENSE H 
696 CLAR< ST 




02*2*2 570-39-11*2 
SANTA M6MICA CAL» 


r> 


2 




ASSEMBLER 


* 2.000 




07-17-67 

ADDRESS 


Ci ABLE uRE'TA f 
3763 *9T9R AVE 




026062 525-62-7036 
SANTA M8MCA CAL. 


M 


* 




SECRETARY 


* 2.550 




07-17-67 
ADDRESS 


laAGE KAREN 
2?0b MATRIX DR 




01851* 537**0-2956 

SA^TA M9SJICA CAL. 


M 


3 




SECRETARY 


* 2.550 





Figure D-2. Sample Retrieved Data Report 
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JUN 11* '69 

DATE £?F 

HIRE 
M9/DY/YR 



E'MPL'JYFE NAME 



NPNCITIZEN FEMALE EMPLOYEES 



MPL 


SOCIAL 


H NQ 


*I9B 


RATF 


NQ 


SECURITY 


r eF 


TITLE 


AT 




NUMBER 


T DFP 
L 




HIRE 



07-17-67 UALLLR CARMEN 

ADDRESS 423 VISTA AVE 

07-17-67 0ALL6WAY L9RI 

ADDRESS 522*6 1ART LANE 

07-17-67 STOUT MICHELE 

ADDRESS 422 KELTOV AVE 

HIREYEAR AVERAGE 



HIREYEAR ITEM C3UNT 000006 



12-06-66 CRUSE MAYbELLINE 

ADDRESS 7177 SJNSFT BLVO 

05-23-66 'JtDWIC< SYLVIA R 

ADDRESS 3756 STEWART DR 

05-23-66 'JE'VSEY F.LLEN 

ADDRESS 1271 WALTER OK 

05-23-66 EVANS JEAN 

ADDRESS 556 16TH ST APT D 

HIREYEAR AVERAGE 



HIREYEAR ITEM COJNT 000C04 

04-08-65 DEA* CLAIR 
ADDRESS 154* HARVARD AVE 
HIREYEAR AVERAGE 



HIREYEAP ITEM COUNT OCOOOl 
•FINAL- AVERAGE 



003391 532-48-7034 M 1 
SANTA MONICA CAL» 

027186 428-62-3078 M 5 
VENICE CAL. 

015954 548-62-7031 M 3 
L9S ANGELES CAL. 



026061 580-33-1414 M 
Mi H9LLY*89D CAL. 

013822 580-47-6683 m 
SYLMAR CAL. 

030008 650-47-6685 M 
LOS AN3ELES CAL. 

011215 621-47-6681 * 
LOS ANGELES CAL. 



013811 580-47-8827 
SANTA MONICA CAL. 



SECRETARY 4 2.400 
SECRETARY $ 2. 375 
SECRETARY * 2.625 

* 2.417 

ASSEMBLER * 2.000 

EXPEDITER 4 2.900 

EXPEDITER $ 3.010 

EXPEDITER * 2.875 

* 2.696 

ASSEMBLER 4 2.100 

* 2.100 



* 2.243 



JUN 11* '69 

NUMBER OK ITEMS RETRIEVED 000021 
NUMBER 9K ITEMS READ IN 000021 



NQNCITIZgN FEMALE EMPLOYEES 



Figure D-2. Sample Retrieved Data Report (cont. ) 
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WAGE INCREASE PROBLEMS 

The Amalgamated Corporation is engaged in wage nego- 
tiations* The management wishes to evaluate the annual 
wage costs of two alternative proposals covering assemblers, 
wirers, and group leaders. The alternatives are 



A 6.75% rate increase for all three classifications. 



2. A $.13 cents per hour increase for assemblers; a $.16 
cents per hour increase for wirers; and a $.25 cents 
per hour increase for group leaders. 

The Director of Industrial Relations has analyzed overtime 
patterns for these classifications and has arrived at the fol- 
lowing formula: 

1 . Estimated annual gross wages for assemblers = (rate x 
2080) + (rate x 1.5 x 102.5) 



2. Estimated annual gross wages for wirers = (rate x 2080) 
+ (rate x 1 .5 x 156.0) 

3. Estimated annual gross wages for group leaders = (rate 
x 2080) + (rate x 240) + $90.00 

The Manage specifications shown in Figures D-3, D-4, and 
D-5 will retrieve the relevant employees and show the im- 
pact of the alternative wage increases on each department. 
Extensive use of arithmetic expressions is shown. In the re- 
trieval specifications, these expressions calculate annual 
straight time and overtime earnings for each employee and 
the anticipated earnings if different increases were applied 
to each job type. The report specifications summarize the 
results of the expressions evaluated in Retrieve and also com- 
pute the effect of the 6.75% uniform increase. The result- 
ing report is shown in Figure D-6. 



SUS 



SIGMA MANAGE GENERAL REQUEST SPECIFICATIONS 



•KOfi I TO 



.(CIRCLE DES 


RE 


D OPTIONS) 










Retr 


eval System 








DA 


rE 


vW 1<W 




REQUEST NO. 


REQUEST SPECIFICATION LIBRARY CONTROL 




ENTER NAME OF: 


SEARCH MODE 


OUTPUT DISPOSITION 


USER RETR.EVAL FORMAT 


kJ,A6,e 




A 


USE MANAGE LIBRARY 


L 


ADD REQUEST 
SPECIFICATION TO 
MANAGE LIBRARY 


A 




PRIMARY FILE TO BE 
SEARCHED 




SECONDARY FILE TO 
BE MATCHED TO 


PERFORM SEARCH 


/ S REPORT GENERATOR T R'SntiRE RECORD 


E 


BY-PASS SEARCH 


B 


USER PROGRAM 


U 


SELECTED FIELDS: / ^ S 
PACKED MULTIPLES { _ , 


PRIMARY FILE 


REQUEST SPECIFICATION 


MftisiT|£|V£, | 




1 1 1 1 1 1 1 




VALIDATE SPECS. ONLY 


V 


PERMUTED MULTIPLES 


P 


12 3 4 5 


6 




8 




Tol 


li 


12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 


|30 




32 




34 



{CIRCLE DESIRED OPTIONS! 



Reporting System 



REPORT FORMAT 


PRINT CONTROL 


PAGE SIZE 


TYPE OF PAPER 


REPORT DATE 


ENTER: 


DETAIL 


D 


SINGLE SPACE 


1 


>EC,AL 







A 


4 


4-PART 


PRINT CURRENT 


•-* 


) 


NUMBER 
OF 

FILE 

RECORDS 

SKIPPED 




RECORDS 
OUTPUT 


GROUP DETAIL 


G 


DOUBLE SPACE 


2 


"-'""- ( 


T 


)-PART 


2 


6 


S-PART 


DATE ON EACH f 
REPORT PAGE 


( 




) 




8 1/2" KViDE XII" 


2 




3 










11" WIDE X S 1/2" 


3 














1 1 1 




36 




38 




40 




42 




44 




46 47 48 49 51 52 53 54 



Report Title - Text To Be Printed At Top Of Every Page 



W,A,6,£l 



fcatiPXftQI.TlAl- A,l.t£&*JATX\/,E, W./V6.5 AJ>J,U£TAiE,^T,s; ,-,C^,F:ri>E,NiTlA,L 



12 3 4 5 6 7 



Title Page - Text To Be Printed On Initial Page 



°.2 TrrlS ZEP.S.Q.J, .EVALUATES W.AG.E, ,T,NS,c,i2,eA£,E,ss, .P.R.ftP.flte.E.D, .Fff.G T,H,E, ,,,,,, 




°, 3 , , , AMALGAMATED, ,MAM,U,FACT,U,(2,I,rt,$, ASft.P.aieftTXtfM 




4 _ 




o,5 P.ET.R.I.EVAL, .EX.P.fc.efeSxeM .ttxXKP.ll.TRg A.MlJ.U.A.L. ,S,T,£AT,<$,t4,T. AaU), e,\lEX?TXHE . 




",6 EAAWI.JJ.G.S ,F,e|fc ,6,U,fc,fc£,lOT .e.AX.E.S, .A.U.1>. T,H,k*J, F,0,£, X^C,£,EAS,£t>, ,£AXE3, BV, , 




o 7 TA>B TTT1_F 




8 _ 




v-o.9rie.ep.ofBT, su.M.MA.exz.es &,v, txxle. .vjJ.xtoi.ki. ,t>.x\/x,sx0*L 
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